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BETTSHOW 

As fast year, I spent some time wandering 
around the 8£TT Show which took place at the 
Barbican Exhibition Centre in London from IBth 
to 19th January (indeed, Beebug also had a 
stand at this show giving us t/ie opportunity to 
meet and talk with many educationaf users). 

Overall, it was my impression that the 
proportion of the show occupied by Acorn and 
companies associated with Acorn, such as 
ourselves, was much the same as fast year 
(when I was somewhat critical of Acorn). 
However, / thought that there was a different 
feel to this part of the show, and that was one 
of much greater substance and maturity. 

There is now a substantial ranpe of software for 
the Archimedes, much of which s of interest to 
educational users (and to home users as well). 
There are still areas of weakness, and ample 
room for the development of further products, 
but in many application areas users now have a 
choice of at least three or four packages of 
quality and in many cases applications are now 
into a second release, with fne consec/tmf bug 
fixing and refinement of the product which this 
implies. 

Acorn staff with whom / fa/ji:ed were quietly 
confident that the future for the Archimedes 
range s now assured, and that with safes of 
over 100,000 a critkai mass in its further 
development has now been achieved. 

RISC USER MAGAZINE DISCS 

The R5C User magazine discs continue to prove 
very popular (a signifkant proportion of our 
readers purchase this regufariy). It is worth 
repeating that not only do we en^vour to padt 
each monthly disc wrth additional bonus items, 
but that much technical effort is put into 
ensuring that all the software is tested and 
updateato make each dbc as robust and reUdite 


as possible. In some cases, we substantially 
rewrite sectiors of programs to ensure toaf th^ 
perform as we diink they should. 

The menu system contained on each disc 
provides general information about each 
program or appikation on tfw disc, and many 
app//caftons include a Help or ReadMe fife 
(jyarticuldrjy in the case of bonus items) with 
further information. We do urge readers to 
make full use of the information provided in 
order to make the most of the software, and to 
ensure that all the requirements for running an 
appikation are known at the outset 

CONTRIBUTIONS 

We are always keen to publish contributions 
from RISC User readers. Articles and programs 
(either for the magazine or for the magazine 
disc) are always welcome, but do try to make 
sure that you conform to toe style and standard 
of other items In the magazine. 

Hints and Tips also form a very vital and vakted 
part of the magdzir}e, and your contributions 
here will be partkularty appreciated, i^ly, your 
letters, wtto comments or queries on any matter 
relating to RiSC User and the Archimedes, wHI 
often he of interest to others, and the best are 
featured in our Postbag and Technical 
Queries pages (indeed some of our articles 
come about oecause of feedbacit from readers). 

Do remember that we PAY for all artkies and 
programs published in the magazine, or on the 
maoaahe disc, and for bints and t^ps. We hope 
to hear from you soon. 

ARCSCANIII 

ArcScan III, the muithtasking version of our 
computerised Index system is proving very 
popular (see elsewhere for details). If any reader 
has developed other indexes hr use with Arcscan 
then we woufci be jhterested to hear from them. 
MM 









File Handling 


by David Spencer and Mike Williams 




A collection of 
7 Original Archimedes 
Gcimes 

ArcOmnibus 


• Amase — a grqihkaDy superb slidiof bkxfc game 
with ■ diffiere^ 

• Cribbwft — an anxOem tnipietoenauion of the wdl 
known aid game. 

• Morie — a oolouffal 'ladders and leveb* game. 

• Ograb Lair a hi^y cntmaiotog arcade type 
game, providing hoin of fua 

• Pick a Pair >> a coloucful game testing your skiils of 
obscrvatian and memory. 

• BalloonMan burst the ballooa a numan style 
of game. 

• Domlnoea — a Desktop venioo of the dasik; game <rf' 
dominoes. 


Ffle Handling for All is a comprehensive book 
which coven all the requirements of data storage and 
p roces sin g by computer, using the popular BBC Basic 
programming langui^ for the cxamplei. It is aimed 
at anybody interested in File Handling and 
Dautwiscs, whether beginnen or more advanced 
users, and will appeal to all who warn to learn more 
of thU important subiecL 

The book starts with an introduction to the 
rudiments of Hie handling, and in the following 
chapters develops an in-dqxh kwk at the different 
types of files e.g. serial flics, indexed files, direct 
access files, and searching and sorting. A separate 
chapter is devoted to Uerardtica] and relational 
database design, and the bocA coocludes vrith 
practical advia on dewloping file handling programs. 

The associated disc (£4.75) contains complete 
working progr ams based on ^ routines de^bed in 
the book end a copy of Filer, a fulFfeaturc Database 
program. 


piPS 


A selection of ' 

12 multi-tasking 

Desktop Applications 
MARCOiNE 

a DataShMC — Data PrcsematioiD Padoge for cresting annotated graphs in 
a vaneiy of formats for (Gsplay or primiog. 
a Cale.570 — Sdcotific Calculator, a Desktop Imf^emcnUtiaD of the Casio 
FX570. 

a CbarDca — Character Deatgncr for crea t ing new lystem fonts, 
a Diary — A multi-taskiiif Desktop Diary and catendar 
a B.to.T — Appheation ffoodlrr which aOowB programs to be edited without 
leaving the Dnktopi 

• HieHiul — File-find utility whkh p cffon m hierarchical search for a givea 
file, applicatioo or directory. 

a Safl^ — Filetype Setter wfaidh you can use to change the fiktype of any 
file by dragging it to the icon bar 

a HfltKayi — A Desktop hotkeys utility that aBowt liitgle key presses to 
perform a wide range of fuoctions. 

a Moom ~ Mouse-speed ContrnBer for changing the mouse speed merely by 
clicking on an icon. 

1 , a Print — Multi-format Print UiOiiy — 
NORMAL MUtTl LAi'ER HISTOGRAM allowt text and progtam files to be 

cta .«• primed hut by dr^ging them to the 

Tin 1 [] 1 n I • NaiaPml - A Desktop N’oteped 

t'H L ‘ L ■ ■ [1 a. appheation which provicks for up to 

k J I n II ■ ■ ■' iitt on the icon bar and dlows Glet to 

J I I I I I I be deleted by limply draggiiv them to 


mArc Three 

3£xdtingNew 
Outline Fonts 

(ChanctUofT, Katxyo and Chbme) 


Desktop PC Disc Reader and 
Background Text Printer 

pluK 

a Sticky BackDrap — plaocs koos anywhere on 
desktop. 

a AppUcadaii Shell Generator for creating 
appheation directones, sprites and !Run 3a 
a Wimp From End for the Baalc Bsfitor. 
a Watchdog Aad-Vlnia — protea your hard and 
floppy diici from viruaes. 

a K^rstrip Gcoeratar (both 9- and 24- pin matrix 
printer versons). 

a Bneoda — a file eocryptioo utility 
a CMOS RAM Managar 

a Ovadoo Clip-ait — from Beebug^ suoceeriul DTP package Ovation, 

a Amaaa — a graphically superb a^ entcrtnining game, 
a A selection of the best Maestro muaie Oke. 

a Advaaead Desktop Preecotatloe Creator screen display with a dnice 
of different fades. 

a Palettt met for Colour Priatcra. 
a A complae la of AreScaa index dau 
for RISC User Magazioe VMume 3. 


BEEBUG LIMITED 

117 Hatfield Road, Sl Albans, 

Hens ALl 4JS 
Telephone: 0727 40303 
Fax: 0727 860263 


■ Order Form 

I DcWtsr AreVotna nw «Mi aaoBHaiaM 

pOiKVK; Stack Cede FDAl 

■An: Ttow Dot J fV.VJ * sep ya|i(UK; Sock Cod« MOS 

I AROB»iiba>Gtaac»OnciaddiK«aKatx»f9V5 » 

«0p pAKinc^ Stack C«Oe RAOM 

Rlt Hctadbi* fcr Ai • a» pap Stack OSe BXOa 

vITta ta RISC Utar i w btav PUe HjaCbas far AS 
btak » Dm £a.9S • fLSOjiltp SMC* Cod* MCOl 
iVnc MU (nuge far Uu din ii far EMope tad £2.40 
^^rwlurc; the book ■ £iaO Eatape and £4*0 cfaMhcr* 
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PORTABLE ARC 

Acorn is to produce a portable Archimedes, 
which will probably appear during the 
latter part of this year. Acorn has not 
released any details at alb but it seems 
certain that the portable will be a high 
specification professional computer, and not 
a budget model* It is rumoured that the 
machine will have an ARM3 processor as 
standard, a high-resolution film-retardant 
LCD monochrome screen and a built-in 
trackerball. A full colour version is likely to 
follow some time during 1992* We must 
stress, however, that none of these details 
have been confirmed by Acorn. 

SOFTWARE DEVELOPMENT 
ENVIRONMENT 

Delegates from 30 companies attended a 
seminar held by Acorn on software 
development in C for RISC OS. The 
delegates were chosen to be representative 
of the range of companies registered with 
Acorn as ISVs (Independent Software 
Vendors) and THVs (Independent Hardware 
Vendors) who develop and market products 
for Acorn's RISC OS hardware platforms. 
During the course of the day, a presentation 
was made of an integrated SDE (Software 
Development Environment) for RISC OS 
that is currently under development at 
Acorn. Acorn plans to release C and ARM 
Assembler products in the latter half of 
1991 which incorporate this environment. 
Acorn will be providing an upgrade 
mechanism for existing owners of Acorn's 
current C and Assembler products, and 
details of this will be announced at product 
launch* Details of all Acorn products can be 
obtained from Acorn Computers Ltd., 
Fulboum Road, Cherry Hinton, Cambridge 
CBl 4JN, tel. (0223) 245200, 

EXPANDED VISION 

Wild Vision has produced an expansion box 
which will allow standard Archimedes 
expansion cards to be used with the A3000. 
The box plugs into the rear expansion port, 
and accepts 2 full-width or 3 half-width 
cards. It has an external 12v power supply, 
and protection circuitry to prevent any 
damage to the computer from external 
supplies. The A3000 Expansion Box costs 
£159.85 inc, VAT, and Wild Vision is making 
a special introductory offer of the box 


together with its Hawk V9 colour digitiser 
for £458.85. For further details, contact 
Wild Vision at 15 Witney Way, Boldon 
Business Park, Boldon Colliery, Tyne & 
WearNE35 9PE, tel* 091-519 145fi* 

COLOUR SCANNER FROM BEEBUG 

BEEBUG is about to release a colour 
scanner package for the Archimedes and 
A3000 based around the popular Sharp JX- 
100 scanner. The unit can scan an image of 
up to 160x100mm in 16 million colours. The 
supplied software converts this to a 266- 
colouT RISC OS sprite that can be 
incorporated into DTP documents etc. The 
scanner package, which will be available in 
mid-March, consists of the JX-100 itself, a 
half-width interface card, disc-based 
software and a comprehensive user guide . 
An A3000 version will also be available 
which houses the interface card in an 
external metaJ case. The complete package 
will cost £665.85 inc. VAT for the 
Archimedes model, and £677.35 inc. VAT for 
the A3000 version. 

MIDNIGHT TRACER 

Midnight Graphics has released Tbnccr, a 
software package which enables you to 
convert sprite files into Draw format. Both 
colour and monochrome images can be 
processed, and the result is a fully editable 
object oriented file which can he 
manipulated easily within Draw* The 
package is particularly useful with 
scanners, digitisers, and other devices 
which produce bit-image pictures* Tracer 
costs £59.95 inc. VAT, and is available from 
Midnight Graphics, 5 Victoria Lane, 
Whitefield, Manchester M25 6AL, tel. 061- 
766 8423, 

VIRTUALLY ARMLESS 

At the time of writing, 30MHz ARM3 chips 
are in extremely short supply. It appears 
that VLSI is unable at present to 
manufacture the chips in the quantities 
needed. As a result, supplies of both the 
A540 and the ARM3 upgrades offered by 
various companies are being held up* 

OTP FOR EDUCATION 

Desktop Folio is a new package from ESM 
which has been designed to provide DTP 
and word processing facilities for 7-year- 
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SCSI HARD DISC 
DRIVES AND 
INTERFACES 
FOR THE A3000 


• From Only £398 

• Fast drives in a wide range of capacities 

• Quality mechanisms {Seagate, Rodime, etc.) 

• Metal case with power supply 

• Fully screened SCSI connectors and cable 

• Easily daisy-chained to provide multiple drives 


Beebug have Jaunched a full range of SCSI hard disc drives for the 
ASiMJO with capacities from 20Mbyte to BSSMbyte. These are all 
half-height quality drive mechanisms housed In an attractive case 
with an Internal switch-mode power supply. Induded in the price is 
a high quality screened SCSI cable and an B bit SCSI interface, 
w'hich fits neatly inside the A3000 module slot. This is supplied 
with fuil fitting instructions and may be fitted in minutes. No 
soiderlng or specialist skills are necessary. 

A number of drives may be daisy-chained together to ^ve in¬ 
creased capacity. All drives are supplied with through connectors 
and the appropriate cables, but units in the middle of the chain re¬ 
quire a set of terminating resistors to be removed. We can supply 
the drives with these already removed. See opposite for ordering 
details. 


SCSI HARD DKIVIiS 
INCTCUING A 3000 INTER!’ACT 

Stock code Capacity Price (ex. VAT) 

5220 20Mbyte £39B.tiJ 

522T 49Mbyte £49 SaIij 

5222 BOMbyte £59B.i)U 

5224 llOMbyte OTHlJt 

5223 lS3Mbyte £H9 S.iki 

5225 338Mbyte £119B.(X] 

Carriage is £8.00 per drive. Add 10 to stock code 
for drives without terminators (e.g 5220 becomes 
5230). Drives are available without Interface - 
deduct £99. 


ARMS PROCESSOR CARD 


# Massive speed increase 

# Riscware control software 

# Comprehensive user guide 

# Compact design using latest 
surface mount technology 

m Compatible with all software 


VAT + £ 5,50 OtTriage) 


The ARM3 micro-processor is the blest in the series of Acorn RISC Machine reduced 
instruction set processor. It Is the miero-prooessor fitted as standard to Acorn's new 
flagship - the 540. 


This new card from Beebug allows a super-fast ARM3 pnacessor running at 32 MHz to be fitted to your Archimedes 300 or 400 
series computer. The highly compact dreuit board measures just 5B by (50 mm (appiox) and contairtB the latest surface mounted 
A RM3 processor together with a dock ^nerator dreuit- 

The ARM3 Card is inserted in place of the existing ARM2 processor and provides a four-fold increase in processor clock speed 
along with a 4Kbyle cache which serves to isolate the fast processor from the relatively slow RAM. Average speed Increases of 3 to 
5 limes are typical, and onJike speed enharioers such as floating point co-processorsH the ARM3 Card improves performance of all 
software. Users of the PC Emulator will ospecially benefit from the increased execution speed. 

The ARM3 Card is supplied with disc-based software to control the cache operation, both from the Desktop and via star 
commands. The compr^ensive user guide not only covers the control of the ARM3 card at all levels, but also contains details of 
differences between the ARM2 and ARM3, and a section explaining the theory of cache systems. 

Nntr; 7^ Beetui ARMS Card must fxfiled ty fin AcDfTi fff^trxdcEimporfent iexi servke ctnire, as Hk ucktingAHM Z ddp is^iobe jwnot-tti TTib ludwis md pnany 

natjat Acorn (kedcTS. Tht Beebug ARM^ k aasaiu^itpr nit A3000, as the ARMl pruEssor tn ttvirhirteksddertd dkssdl]^ toihedread kwfii 


Please add VAT at 15%. This advert wa 
produced cnliinely with OVGtiDn DTP 


Heebug Ltd., il7 Hatfield Road, St Albans, Herts, ALl 4JS. 
Tel. 0727 40303 Fax, 0727 S602G3 
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olds and upwards. Developed from the 
original BBC Folio, it operates at two 
levels: Simple Screen Folio provides an 
easy-to-use introduction to DTP for younger 
children, while Desktop Folio offers more 
versatile facilities which ESM claims will 
cater for all school DTP and word 
processing requirements* Desktop Folio 
costs £103*50 inc. VAT for a single copy, and 
site licences are available for multiple 
users. Further details can be obtained firom 
ESM, Abbeygate House, East Road, 
Cambridge CBl IDB, tel. (0945) 63441* 

FOREIGN LANGUAGE FONTS 

Outline fonts for Bengali and Punjabi 
characters are now available from the 
Hampshire Micro technology Centre* The 
fonts were developed primarily for use 
within Hampshire schools, but have been 
made available in order to meet similar 
needs in other areas. Each font comes on a 
separate disc, together with sample Draw 
and Poster files and a keyboard overlay. 
The keyboard layout generally corresponds 
to that used by BBC Folio, as it was felt 
that many users will already be accustomed 
to this layout. Each font costs £20*00 for a 
site licence, and discounts are available for 
area licences. The Hampshire 
Microtechnology Centre is at Connaught 
Lane, Paulsgrove, Portsmouth P06 4SJ, tel. 
(0705) 378266. For further details of the 
fonts, contact Martyn Wilson, Inspector for 
Technology (IT), on (0703) 715217* 

IMAGE CONVERSION 

X_Imagej from Foster Findlay Associates, 
converts Archimedes sprite files into TIFF 
and other formats widely used on PC and 
other computer systems* With the Arc being 
increasingly used for the generation of high 
quality images, the facility to export these 
to other systems should prove very useful. 
XJmage is available at a nominal cost of 
£10*00 from Foster Findlay Associates, 148 
West Road, Newcastle upon Tyne, NE4 
9QB, tel. 091-2731111. 

RISCBASIC EXTENSIONS 

Silicon Vision has produced a new Desktop 
Developers Environment (DDE) for its 
RiscBASiC compiler, which will allow Basic 
source programs created in Edit to be 


compiled simply by dragging them onto the 
RiscBASiC icon, with syntax errors being 
highlighted in the Edit window RiscBASiC 
itself is now being supplied as version 2.06; 
registered users may upgrade free of 
charge, or may upgrade to V2.06 with the 
DDE for £50.00 inc. VAT. Silicon Vision is at 
Signal House, Lyon Road, Harrow, 
Middlesex HAl 2AG, tel. 081-861 2173. 

MISSING LINK 

The Missing Link (TML) is a new high 
speed data link from D.R. Computer 
Products, which has been designed to 
transfer data between two Archimedes. The 
hnk consists of a card which plugs into the 
Econet socket (it does not use a podule slot)* 
Any two machines fitted with link cards can 
be connected by a cable up to 10 metres 
long (3 kilometres with a fibre optic cable), 
and data transmission takes place at up to 
10 million bits per second. A Desktop File 
Transfer Utility is provided, and typical 
transfer speeds using this are 40K- 
120Khytes/sec. The price of the card is 
£74.95 inc. VAT, and further details can be 
obtained from D.R* Computer Products, 
Unit 20-21 Enterprise House, 44-46 Tferrace 
Road, Walton-on-Thames KT12 2SD, tel. 
(0932) 240432/566435. 

ALL IS REVEALED 

Revelation is a new product from Longman 
Logotron. Developed at Homer ton College, 
Cambridge, it is an advanced art package 
designed specifically for children* Its range 
of colour manipulation facilities, including 
washing and blending, make it particularly 
useful for processing images taken from 
other sources, e*g. digitisers and scanners. 
All the other features you would expect 
from an art package are present, plus new 
facilities such as a set of measurement tools 
which allow the user to measure angles, 
distances and areas within a picture, thus 
making it useful for maths and science 
applications. Claimed to be very flexible, 
user-friendly and useful right across the 
curriculum, Revelation costs £87,40 inc. 
VAT (with a limited introductory offer of 
£62.10 until the end of March). Contact 
Longman Logotron for further details at 
Dales Brewery, Gwydir Street, Cambridge 
CBl 2LJ, tel, (0223) 323656* 
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Desktop Zoom - 

Magnify your Desktop with this short appiication from Mike ironmonger 


T he Magnifier application supplied on 
ApplicationB disc 2 lets you look at an 
enlarged image of a small part of the 
Desktop, Desktop Zoom on the other hand 
will give a fiill screen enlargement of the 
Desktop at up to 1000 times magnification, 
where one pixel takes up more than the 
whole screen. It is mouse controlled, and 
you can zoom in and out, and pan across 
the whole area by moving the mouse in 
any direction. 

The effect is very dramatic, and may 
even have some use! It is very handy for 
seeing at a glance the way in which 
application sprites have been drawn. 
Moreover it may be useful in certain 
teaching situations where it is necessary 
to view a monitor from a distance. 



Zoomfng in and out is easy 


SETTING UP THE APPLICATION 

To install Desktop Zoom on your 
machine you will need to create a 
directory called !Zoom, and save within it 
three files with the following names: 

1. !Run 

2. JRunlmage 

3. ISprites 

IRun 

The contents of this short file are given in 
listing 1. This file must be of type Obey, To 
create it, just use Edit, select Create New 
Obey file from the main menu, and type in 
the listing. 


ISprites 

This is a standard sprite file. The easiest 
way to obtain an appropriate sprite is to 
“steal” the one used in the tMagnifier 
application on Acom^s Applications disc 2. 
To do this, hold down the Shift key, and 
double-click on the [Magnifier apph cation, 
so revealing the contents of its directory. 
Then load the ISprites file from this 
directory into Paint, and rename the 
sprite IZoom (using Paint's menu). Then 
save the sprite file (keeping the filename 
ISprites) to the IZoom directory. 

IRunlmage 

This is the Basic program given in listing 2. 
First enter Basic by pressing FI 2 from the 
Desktop, and then typing: 

Basic 

Type in listing 2 and save it to the IZoom 
directory with the name IRunImage. 

USING THE PROGRAM 

Now get back into the Desktop, and 
double-click on IZoom. This will install the 
application on the icon bar. Clicking Menu 
from here shows just one entry “Quit”, To 
make the zoom facility operate, click with 
Select over the icon on the icon bar, and 
the process wiU begin. Each further click 
on Adjust will increase the magnification, 
while each click on Select will reduce it. 
Moving the pointer around pans the view. 
To get back to normal, just click with 
Menu (regardless of where the pointer is 
positioned). 

Listing 1 

I iRort file for !£oom 
WimpSlot -min 16K -max 16K 
Ron <0bey$Dir>,!RunImage 

Listing 2 


10 REM 

>fauQXa*9« 

20 REM Program 

Full screen zoomer 

30 REM Version 

A 1,Q0 

40 REM Author 

Mike Ironmonger 

50 REM RISC User 

March 1991 

60 REM Program 

Subject To Copyright 

10 ; 


8 0 OH ERROR P ROCe r ro r{E RR,REPORT $ ] :GO 

TOIIO 
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Desktop Zoom 


90 PROCinit 
TOO : 

no REPEAT 

120 SYE”Wimp Poll’*,blocks TO A% 
130 CASE m OF 

1^0 WHEK 6: PROCmQuse_click(block%! 

150 WHEN 9: quit%=Ublock%=0} 

160 WHEN 17,16: quit%=fblock%[l6-0) 

170 EHDCASE 
130 UNTIL quit! 

190 SYS"tfimp_CloseDown^ 

200 END 
210 : 

220 DEFPROCnK>use_click 
230 CASE OF 

2^0 WHEN 2 i PROCcreate_mGnLif!blDck%l 

250 WHEN 1,^ : PROCzoom 

260 ENDCASE 

270 ENDPROC 

230 : 

290 DEFPROCcreate_menu (J5%) 

3D0 SnierLij|="2oom* 

310 [nenul!12-s70207:mersu% 116=100 
320 menu%!20=44:!nenu%!24=0 
330 menu%!2e=te0:menul!32=0 
340 menyl!36=S70fl0029 
350 $(menu%+40)='’QQit™ 

360 SYS"Wimp_CreateMenu'^, ,menu%,X^-70, 
140 

370 EHDPROC 
380 : 

390 DEFPROCzoom 

400 SYS‘'OS_ReadModeVariable’,HODE,7 TO 

r t 

410 req%+=l00 

420 SYS’'X0S_Module",6, TO ,,spr% 

;F% 

430 IF F%AND1 ERROR 1, ''Can't claim enc 
ugh memory for the zoom*” 

440 iB pr%=req%: spr%! 4=0 
450 spr%!8=16:sprl112=16 
460 I 

470 scw%-l280rECh%=1024 
480 IF MODE=l6 OR MODE=17 OR MODE=24 3 
cw%-2ll2 

490 SYS"OS_EpriteOp",illD,spr^,"screen 
”t tt ^scw%-l,sch%-l 
500 scaled38=scw%:3cale%ll2=sch% 

510 : 

520 ox%=0:ciyl=0^maq=2iomag-0 
530 PROCwait 
540 : 

550 REPEAT 
560 PROCmove 

570 IF NOT quitI PROCplot 
5B0 UNTIL qultl 

590 SYS"GS_Spi:iteOp"^ 1122,3pr%; "screen" 


600 SY3"OS_Modijle",7,,spr^ 

610 SYS''XOS_GhangeDynamicArea", 1, -req% 

620 qult%=FAL3E 

630 PRCJCwait 

640 ENDPROC 

650 : 

660 DEFPROCmove 
670 REPEAT 
680 MOUSE x%,y%,bl 
690 CASE b% OF 

700 WHEN 1 : niag+=mag/20: IF maq>1000 
iRaq=10OC] 

7X0 WHEN 2 : quit%=TRUE 
720 WHEN 4 ; [nag-^ag/20: IF mag<l ma 
g=l 

730 ENDCASE 

740 UNTIL x|<>ox% OR y%c>oy% OR magoo 
mag OR quit% 

750 : 

760 x%=scw%/2"X%*mag;w%=3Cw%*tnag 
770 IF x%>0 x%=0 

730 IF x%+w%<3cwI 41 x%=sctt%+l-tf% 

790 yl'Sch%/2-yi *mag: hl=sch%*rnag 
800 IF y^>0 y%=0 

810 IF yHh|<sch%+3 yl=schl+3-h% 

820 ENDPROC 
830 ; 

840 DEFPROCplot 
350 ox%=xl:oy%=y%tomag=mag 
360 3scalel=w^:scaie4i !4=Li 
370 SYS"OS_SpriteOp",4134,sprl^"screen 
",x%ry%r/scale% 

880 ENDPROC 
890 : 

900 DEFPROCwait 
910 REPEAT 
920 MOUSE x|,y%,bl 
930 UNTIL b%-0 
940 ENDPROC 
950 r 

960 DEFPROCerrcr{!bIock%,$<talock%H}) 
970 SYS"Win^_ReportError’’,block%,lr 
om" 

930 ENDPROC 
990 : 

1000 DEFPROCinit 

1010 SYS"Wirnp_lnitiaUse",200,440534154 
,"Zoom" 

1020 DIM blocks 99,scale% i5,menu% 99 
1030 qult^-FALSE 
1040 : 

1050 [blcck%=’nblock%M-0 
1060 biock%18=0ibIock%l12=68 
1070 block%116=68;biockl!20=4300A 
1080 S|block%f24)=''!Zoom" 

1090 S Y S"Wimp^CreateIcon",,bloc kl 
1100 ENDPROC 
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ArcScan HI 

A new multi-tasking version of Arcscan, the customisable magazine database 


New features for ArcScan in 

• now includes subjea and fiinaion index to Aoom's 
AI^'Sl-C manual (Release 5) 

• provides flexible keyboard search on any entry 

• improved search logic - choice of 3 logical operators^ 
OR, AND and NOT 

• features dynamic memory management, returning 
unused memofy to the Wimp 

• uses dedicated ARM code routines enabling rapid 
information retrieval 

• finds are displayed in a fast saoJling Wimp window 
allowing you to browse through all entries retrieved, 

■ fully user customisable allcFWing other databases to be 
automatically incorporated in the control panel display 

• a new detailed manual and extensive on-screen hdp 



Searching is almost instantaneous 



If itiinMli Bit 
IlirGlfl 


1---1 

imO H!TO 

1_1 

Fi*«t: 1 t 1 

m 

use IW 

0 

Kim 

0 

iU Kt ilHiiih 

o 

NfH Hra HihiIi 


ANSI ( HwnI 

o 


The on-screen help in action 


ArcScan ni contains the Following Databases: 

• RISC User Votumes 3, 2 and 3 

• BEEBUG Volumes 1 - 8 

The Indexes to the following major Archimedes manuals: 

• Basic User Guide (Arthur) 

• Pmgrammei^s Reference Manual (Arthur) 

• RISC OS User Guide 

• RISC OS Basic Manual 

• RISC OS Programmer's Reference Manual 

• ANSI C Manual (Release 5> 


It is simple to perform a search: 


1. If you need to know about Obey Files, enter the words ‘obe/, 'files' and click on Ihe AND logic All finds In RISC User 
wRl be Instantly displayed. You can now call up the Acorn Manuals indexes and repeat the search to get further 
leferenoes. 

2. To find the SWI name for SWT &40QD4, selea the new Programmer's Reference Manual from the menu, enter "SWl 
&400D4’', and the answer appears, complete with page references. 



AicSi^lj^^Dlsc + itl4*95 memb^ <Jia95.rK>nhiiieiiibets) Stock Cddc'PASS 

3m (from Arc^^ ; i^-75 tw^mbers ht^jirembers> :^^Co^.pA]U3 

: : Pfewe add^ tqsgadc, please send the cM n diu or 

’l;:- When onfa^ ptease qoow ytjtir narhe and membersh^ number. 


BEEBUG Ltd, 117 Hatfield Road, St Albans, Herts ALl 4JS. Telephone f0727? 40303 Feu: 10727; 860203 






Magpie -- 

Information Organiser from Longman Logotron 


Reviewed by Mark K, Seafey 


WHAT IS MAGPIE 

Magpie is an easy to use yet 
relatively sophisticated package which 
presents visual and textual material 
both on screen and optionally as hard 
copy. It is intended for use in schools - 
typically for project work - but has 
many other uses. 

For example, anyone needing to 
work interactively with information on 
screen or to compile presentations 
using graphics and text, as well as 
sound, could use Magpie as an 
alternative to Genesis IL 



A copyable utility for “reading” 
material created with the package (but 
not for editing it) allows presentations to 
be freely distributed for use by others who 
do not own Magpie itself 

Yet the product has potential as a basic 
desktop publisher too; this is chiefly 
because it makes use both of an intuitive 
interface and of the Acorn Outline Fonts. 
In general, its speed of operation, data 
compression techniques and overall feel 
mean that anyone interested in this type 
of software should look seriously at Magpie. 


Figure 1. Potential information sources fora 
Magpie flie 

by Longman Logotron onto it. Magpie only 
works with RISC OS: and Acom^s useful 
Sysmerge utility for updating !System to 
the latest versions of the modules is 
included with the package. 

USING MAGPIE 

Once Magpie is installed on the icon 
bar (the application is fully multi-tasking) 
work can begin - either by dragging a 
Magpie file onto the main icon or clicking 
Menu over it to create a new folder. 


THE PACKAGE ITSELF 

Magpie comes on two discs (program 
and examples) with the usual Logotron- 
style key-disc protection system. This will 
be a disincentive to many users, 
particularly those in small schools who 
cannot afford a site-licence and for whom 
safe storage of “^the original disc” may not 
be guaranteed. There is also an excellent 
A4 size 75 page manual. 

It is advisable to follow the lengthy 
and thorough “getting started” section of 
the documentation. By the time you have 
done so, you will have made a separate 
data disc and copied those !Fonts supplied 


The physical model for Magpie is that 
of the ring-binder; it is composed of 
sections each with one or more pages. Both 
can be moved or new ones added, and a 
page can contain graphics (including 
sprites), arrows and lines for annotating 
the graphics, text, frames and rectangles 
(see fig.l). Additionally these pages can 
include sound samples and music 
(IMaestro files). What is more, they can be 
linked so that the user can follow a theme 
or work interactively through a 
presentation. More of this linking later. 

Modelling all of this on screen in a 
consistent and accessible way was always 
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going to be the moat challenging task for 
Magpie's designers and programmers* As 
well as providing a main text-bearing 
menu box for overall page operations, they 
have opted for a relatively standard, 
Impression-like, style of plinthed dialogue 
boxes. 


The purpose of some of the icons, to be 
truthful, is not as self-evident as it might 
be. A colour crib-card with the product 
(showing icon functions and all text 
equivalents, perhaps in menu*map 
context) might have been helpful. 
Nevertheless, the tutorial takes you easily 
through the process of creating a Magpie 
"bindei^ and dividing it into sections of 
your own choice. 



Figure 2. Magpie binder contents page 


Imagine the theme was architecture, 
then the “sections” might be: building 
techniques, materials, famous architects 
etc. The pages might then contain 
annotated examples appropriate to the 
section: biographies with scanned 
portraits, text on stones or line-art of 
construction methods. A section can, and 
usually will, contain several pages. 


When you begin to lay all this out, you 
will be asked if you want an A4 or A5 size 
folder, although the default (and prefeired) 
size is that of the screen itself; at this 
stage you can also change parameters 
relating to colour. When it comes to 
graphiCB (from Draw, say), the aspect ratio 
can be preserved during rescaling* This is 
only one of many touches that add to the 
appeal of the product. 

MENUS AND ICONS 

Although you are led through the set¬ 
up stage with whichever of Magpie's 
menus are necessary, moat of them are in 
fact context-sensitive or can be popped up 
when required (mouse Menu button). 
Indeed, you quickly become used to finding 
your way about the package. Chief among 
the menus is the main page toolbox. This 
has eight icons to edit a page, and permits 
sizing and placing of objects, text-entry 
and editing, styles and formats of display, 
linking and hrowaing etc* 

Again, the purpose of all these icons is 
not as memorable as it might be* There 
are few to learn, however, and the 
reference section of the manual is a model 
of clarity, so this should not be seen as a 
major drawback. The relevant icon 
appears in the wide left-hand margin in 
case you should forget. 

LINKING PAGES 

It may well be at this point that you 
wish to enable later users to "turn” pages 
within the binder - by means of "buttons”. 
This is easier to do than to explain but 
basically allows you to consult pages in 
various sequences, extract objects from 
the presentation for use in your own 
applications and hide/reveal or “play” 
them as appropriate. 


Although both pages and sections can 
be added as afterthoughts, some planning 
is advisable. You are free to place all 
scanned and sampled material as well as 
text and graphics files in a disc directory 
of your own choice. 


For instance, the designer of the 
presentation may want to simplify it by 
introducing the illustrations only after 
chunks of text have been read or by 
directing the reader to a section of the 
hinder where all the illustrations are 
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grouped. Later in the presentation it may 
be necessary to visit the illustrations 
again, this time in a historical sequence 
arranged according to time. But now the 
routing could well be entirely different. 




Jl 


PSBE EDimti: Itw eib far plicid n i fift feyt niaf twls li 
tbF tKllNW <ftr MttrlBfi text, driirlii^ linffS> vmif ud 
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dirtet^r^ djjp 1 >!fs v dirntlif frAH uthir afpHtiiiws- 

Ikt FliHd 4fl ■ Nft 11 Ctt iuilpi1«trd iiliig t4e <tlflr 
tHlx ifilliblrj iia*i!»f ud rftrdtriM nr 

Hit ^ipEf eolfir If I OH bfl i^ivd Bsinf t mib opUhi. 
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I bTH files. Iite m lU text 
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Sumd IMP Lie, frii IlIrHihis 
. tt If nidi Ui S bit mwLck, 
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I Nittie flLii frM tikntn, 

I dlsplojfHj Ul«9 t 'cpf4bir'« 


T«t llltf. m be 
I iwted t* text fruvi 
lilt tbi pel t«L). 


Are otber file <liit ul 
dlreetorlis, is ^£?d by 
btfreeiini lul ^ohis) mi be 
plmd in j fiyi. Ii thif lut 
tbe file type Ihi fr the file 
wU be dlspUied. 




Figure a File types directly usable by Magpie 


Such pages will contain either a 
graphic or text prompt inviting the user to 
click with the mouse and/or use specified 
keypresses to follow this routing, which 
needs to be quite sophisticated; in some 
respects it may turn out to be not very far 
removed from teletext page routing 
techniques. 


Once again, use of the dialogue boxes 
necessary to achieve all of this is logical 
and straightforward. For example, the 
plain “button icon” is selected and a 
button to “turn the page” is placed exactly 
where you want it on the screen, typically 
at the bottom right. This placing is 
achieved by exactly the same mechanism 
used to position and scale any other 
Magpie object. 

The button's characteristics can be 
altered at will: it can be transparent, one 
of several predefined graphics (an open 
book for pages backwards and forwards or 
a selection of arrows) and may or may not 
set a “tag” for the user to skip straight 
back to this same starting point in the 
binder when the page pointed to by the 
button has been read. 


Quite intricate and lengthy interactive 
learning sequences, too, can be built up 
very easily by using this featur_ of 
Magpie. Of course, all the data relating 
not only to the material itself but how it 
behaves in this latter respect is saved in 
one file somewhat like a much scaled- 
down and static interactive video disc. 

SOME PROS AND CONS 

A data compression technique is 
employed so that a full page with perhaps 
two graphics and three or four boxes of 
text, annotation and links occupies no more 
than 12K, which could actually well be less 
than an original sprite contained in it. 

The downside is that a screen may 
take several seconds to appear in full, and 
there is no overall indication whereabouts 
in the binder you are at any one time, 
except by referring to the window title ban 
There are other very minor snags in 
editing with Magpie. A text's font cannot 
be changed once the text has been entered 
and displayed; to make up for this, the 
selection of font, leading and sixes is 
amongst the easiest for packages of this 
kind now available for Acorn machines. 

Pages can be printed, singly and in 
sequence, using the RISC OS drivers. Tfext 
can be searched, imported from other 
applications such as Edit, and all manner 
of alterations to material made very 
easily. 

There are intelligent control key 
equivalents to some of the operations, and 
the relatively shallow menu structure as 
well as total Desktop compatibility make 
Magpie very easy to use. 

MAGPIE READER 

Once you are happy with your pages 
and their contents, you (or someone else) 
will want to use them. This is where 
MagpiReadj the browser supplied with the 
package, comes in. You will discover from 
the manual that you can distribute this 
module with your pages (which are thus 
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Magpie: Information Organiser from Longman Logotron 


not entirely stand-alone) provided you Longman Logotron Has also designed a 

make no charge. menu/control structure that, while 

perhaps relying too heavily on icons, 
Here, although it uses similar makes good sense and speeds up, rather 
conventions to those of the main program, than hinders, what you are trying to do. 
passage through and selection of features 

on the pages is direct and self-evident. Advanced presentations would he 

Again, the videodisc analogy springs to better done with Genesis IL But where 
mind, though things are much simpler, clear easy to achieve results are needed 
easy to use and effective. quickly, and full control of the on-screen 

effects is at a premium (for first time 
CONCLUSIONS users and children, maybe), Magpie - at a 

Longman Logotron has come up with a reasonable stand-alone price and with its 
winner. Unlike some of the more complex excellent manual - can be thoroughly 
DTP packages, Magpie has been limited to recommended, 
a simple specification with just those 
features anyone wanting to edit pages Product 
simply would want. There is just the ri^t Supplier 
number of 'drop shadow' and frame type 
options; colours are limited to 16 and 
there is no plethora of arrow styles, for 
example, with which to label diagrams; 
most pleasing results can be achieved 
using those provided. Aft pricss exclude vat and pap. 

iVoiceBuilder 

from MJD SOFTWARE, the makers of 

iVoiceBuilder is a new package from MJD Software, offerir^ the user a 
powerful, but easy to use facility for creating new sound VOICE modules. 

Within minutes, new instruments and effects can be created for use with all commercial 
music packages, or within your ovm programs. 

Main features include: 

Selection from wide range of waveforms and envelopes 
Full control over the time domain for attack / looping / release phases 
Separate loop positions for amplitude and pitch envelopes available 
Sounds instantly available for testing via keyboard or MIDI 
Full RISC-OS multitasking - use alongside Maestro, Rhapsody etc. 
Ultra-compact module storage - 8 voice module takes up roughly 13k! 

AVAILABLE NOW FOR ONLY £1 9.95+£i .50 P&P 


magpie 

Longman Logotron 

Dales Brewery, Gwydtr Street, 

Cambridge C81 2LJ. 

Tel. (0223) 323656 
£54.00 (atand alone) 

£175.00 Primary site licence 
£300.00 Secondary site licence 


MJD SOFTWARE 13 BURNHAM WAY LONDON W13 9YE 




Beebug Public Domain Sollware - New Releasej^l 

MM !■ ■ KC I ^iiv-.xAtA • j - _ — • i- m 0 M i mm,yim K^ T 

This list includes 7 new discs C* ) added last month to our public domain library. Further titles will be added tn the future. 
Wte are also offering a Sampler disc with a selectiort of public domain programs from all areas of interest. 

Unlike other Public Domain software, our discs contain as near as possible to 800k Cand not less than 700k)- 
Eadi disc indudes a ’Read Md file, and there are some instnjctions with the programs 
rt is our policy with our public domain library that the Public Domairj discs are available only to RISC User members 
for i2 99 (postage is 60p for the fiist disc and ^p for each additional disc). The discs are ofTer^ as seen^ arid we cannot 
enter into any discussion regarding their oonients. 

To order phone (0727) 40303 , Fax (0727) 660263, or write to (quoting your membership number): 

BEEBUG, 117 HatHeld Rd, St. Albans, Herts AEl iJS, 


DEMOS 

PD 12 D 1 SC 

Contains 5 sound and graphics demois from Hugo Fiennes 
of the Serial PorL All five are stunning examples of what 
the Arc is capable of. 

PD21 Disc A 

Contains three demos Balls, BaJJs2 and BIA-Tetris. The 
latter is a game as well as a demo. 

PD 22 Disc 

Contains three demes, Noah, Chips and DemoOl. 

PD23 Disc * 

Contains four demos. Bounce, Crimbo, ColDemo and 
Rotate. 

PD24 Disc * 

Contains three demos, Demo, Gopher and Overscan, 
f Di^ 

iins four demos, E>eskballs, DudsDemo, Eglntro, and 
2-Brother. 

PD 26 Disc -k 

Contains three demos, Sister, Wibble and SkuUE>emo. 
PD27 Disc k 

Contains two demos, GiannyChow and Wirxlows. 

GRAPHICS 
PD 13 Disc 

Contains the IProjeaor application that displays 
films created with the Acs Computing Mogul 
package. Six example films are indued. 

PDl gnihc * 

Contains a program that displays several still 
and animat^ ray traced pictures. 


GAMES 

PD19 Disc 

Contains 10 games programs, Adevriture, Battle, 
Battleships, Connect4,Darts, Fish (PelmarUsm), Fruit 
Machine, Golf, Hangman and Impact, 

Pn 20 Disc 

Contains 12 ^mes programs, Invaders, Line Of Five, 
Othello, Pelmanism,Rocks, Rubik Cube, Simon, Solitaire, 
Star Trek, Tetris, Tile Trial and Yahtzee. 

iTmnins 

PD2ft Disc 

Contains 20 utllJCies of various types. These are all 
extremely good and there is something hene no doubt to 
please everyone. Space does not permit full descriptions 
but the file list is, IstFile, ASm2, CloseUp, Crypt, Dir, 
Display, Drawlink, Dustbin, Flletypes, FileU^s, Find, 

Keys, toadprogs, MultiPrint, New^r, NewCodes, 
PDJmpress, PrinterT k, FrogCalc, and Set_Type. 

f XIPAKT AN1> Pltrn iRI-S 

PD 29 Di!^' 

Contains over 4 megabytes of Sprite pictures which can be 
used as dip art to load into DTP or use in your programs. 
The files are naturally in a compressed Form and the disc 
contains the file to uncompress them and has instructions. 

FD.W) Di^t 

Contains over 2 megabytes of Sprite dip art and Draw files 
to load into DfP or use in your programs. The files are 
naturally in a compressed form and the disc contains the 
file to uncompress them and has instructions. 


HOGOmON 
Ptn4 DL^sc 

Contains FTG, a suite of programs for 
recording student achievement levels in 
schools. Also, included is a way of recording 
attainment with Colton Software's Pipedream. 

ART 
PDIS Disc 

Contains Afctist+ and BigM, both 256 colour 
art packages, along with Design, a 
symmetrical pattern designer. 

MUSIC 
PDI6 DLsc * 

Contains 230 tunes for loading into the music 
package Maestro, with enough variety to suit 
most tastes. 


TRICKS AND NOVELTIES 
PD 17 Disc 

Contains a collection of 27 amusing trick and 
novelty programs. Some of them produce the 
weirdest effects? 


Public Domain Sampler Disc (PDSJ > 

This disc contains sample pragrams from the Seebug Public Donuki Software 
Library. The piDgrams aje as fbUows^ 

STmekef ■ The STracker applkahon is us^J ua back a nrusic fde toccata made 
of real sampled sounds which arc sequenced to form a complete tune lasting several 
minutes, T^ quality of this is quite stunning, pankularly if ^ayed through the 
computer's monitor speaker, or a hi-fi sysiem. 

Aooounta > This is a home accounts program. There are no tnatructions induded 
with the program bui all functions are sefected from the main menu which is self 
^pknat^. An exair^le file is included. 

DlscLabel - This k a versatile disc labelling program producing professional looking 
labels for 3.5” discs, A Help file is induded with the pcogram. 

FoBdw - This is a novdty program ihat when run puts a pair of beady eyes on the 
dedaop that follow the mouse pointer wherever it ^>es. Eerlel 
Hangma n - A well presented and implemented version of the old word game of 
Hangman with an anlmaeied finale, 

MuldpifimC:' A utility to allow the priming of files by creating a task list of the file^ to 
pdm before sending them to the printer. A Hdp file is included within the program. 
Rotate - A fascinating animated demo In which you can alter the effects by pressing 
a few keys on the keyboard- 

Sn> - A useful utility to seaidi foe tdephone STD codes o? find a town from its 5rrD 
code. A ReadMe file is included ki the prograiri- 

- A novdty diemo program that infests your desktop screen with a shoal of 
bubble-blowing goldfish! 












Hard Disc Archiver 


by J,V, Parker 

he program presented here enables 
you to back up a hard disc onto a 
number of floppies, and has been designed 
for both ease of use and program 
simplicity As a result, it can be typed in 
with veiy little effort. The program is not 
multi-tasking, since when writing to or 
reading from disc the CPU has very little 
spare time (try running Usage on 
Applications disc 2 while backing up a disc 
to see what I mean). It doe&n*t need to be 
an application because it has no sprites or 
resources and runs from the root directOTy 
of the hard disc. After setting up the 
program initially for your system, it will 
archive the complete hard disc the first 
time it is run, and thereafter will just 
update the files which have a different 
date stamp from those in the archive Ci,e, 
the latest versions). 

One useful feature of the program is 
that archived files are not stored in a 
compressed form, so they can be run from 
the backup discs or just dragged into a 
filer window. 

SETTING UP THE PROGRAM 

PROCinitial sets up the variable 
strings which are used to control the 
cop3nng process. These strings define the 
source and destination paths, and the 
copy options which will be used. The 
source path in line 180 should be tailored 
to suit your drive, e.g. if you have a SCSI 
drive it might read: 

180 hard?-'*SC3]:;:SCSIDisc4.$.’' 

The copy options defined in option$ are as 
follows: 

A(ccess) on. 

« C(oiifirm) off, otherwise youll wear 
your mouse out. 

-D(elete) off or you’ll wipe your hard 
disc. 

F(orce) on to ensure that older copies 
on the floppy are overwritten. 


Uook) on. 

N(ewer) on to ensure only newer files 
are updated. 

^P(rompt) off - not needed when 
copying from hard to floppy. 

Q(iiick) on so that application 
workspace is used to speed up the 
process. 

R(ecurse) on to copy sub-directories. 

^Sftanip) off. 

(s>-T(ructure) off since you want the 
files as well as the directoiy structure. 

"V(erboae) off (unless you have all 
night to check the names). 

These are all documented in the iSisc 
OS User Guide pages, 202-204 or 208-210 
depending on your version of the Guide. 

If you have a program which writes 
files without date stamps (e.g. a BBC 
program running under !66Host), then 
you will need to change option! to ignore 
date stamps, ie, change N to -N, Also, 
files which are written to (e.g. using 
OPENUP) do not have their date stamps 
updated automatically so if you have a 
directoiy where this happens on a regular 
basis, you'll have to change the Newer 
option for that as well. In the example set¬ 
up shown in the listing, this is done in the 
case of floppy disc 7 (lines 440-470), where 
option! is changed before and after 
archiving IViewsheet. 

USING THE ARCHIVER 

The first step is to format and name 
enough discs. The names are BUI to 
BU/i. To calculate how many discs will be 
required (i.e. the value of n), you must 
first decide what is to go onto each disc. 
Use the Count option provided by the 
Filer to find the total size of all the files 
in a directory, then add 2K for the 
directory itself and the same for any sub¬ 
directories. If you aim to put a maximum 
of, say, 500K on each floppy, this will 
allow plenty of room for either new 
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programs or revised versions under a new 
name when you come to update your 
archive. 

Having done this, you can then write 
PHOCnpdate to suit your system. Each 
WHEN clause refers to the floppy of the 
same number, e.g. in the statement 
following WHEN 1, the parameter passed 
to PROCosc defmea the directories to be 
put onto disc BUI (in this case a single 
directory called ! Fonts). You can place 
more than one directory on any floppy by 
simply making additional calls to 
PROCosc, as in the example for floppy 2. 
However, if a disc is to contain only part of 
a directory (as for disc 5 where only part 
of directory C is copied), then you must 
create directory C on BUS first, otherwise 
you will get a Slot found" error. 

Bear in mind that if you undertake a 
m^br restructuring of the organisation of 
your hard disc, you will need to edit 
PROCupdate, but you will not need to re- 
archive anything for which you still have 
the original backup discs. 

The program will not wipe files from 
the floppies which are no longer present 
on the hard disc, so eventually you may 
have to wipe them manually from time to 
time to avoid running out of space. As long 
as a floppy still has the same name, it will 
still work even if you have wiped it clean, 
though the next time it is used all files 
will be copied. This does have one 
advantage: if you wipe something from 
your hard disc and decide later that you 
want the file after all, it may still exist on 
the backup disc. 

10 RflM >Arcblvar 

20 EEM Program Hard Disc Backup 

30 REM Version A 1.00 

40 REM Author J.V.Farker 

50 RISC User March 1991 

60 REM Program Subject to copyright 

70 ^ 

80 ON ERROR PROCerror:EKD 


90 PROCinitial 
100 FOR I%=1 TO 30 
110 PROCupdate 
120 NEXT 
130 END 
140 : 

150 DEF PROCinitial 
160 oscliS="" 

170 copy$="Copy" 

180 hard$-’‘ adfsr:4.$." 

190 floppyS-” adfs:;BD'' 

200 disG$=".$." 

210 option$=" A HO -D F L N -P Q R 'S 
-T -V" 

220 from$-'’" 

230 ENDPROC 
240 : 

250 DEF PROCosc (from?) 

260 oscli?=copy$+ha rd$ +from?+floppy?+S 
TR$II+disc$+from? toption? 

270 OSCLl OEcli? 

280 ENDPROC 
290 : 

300 DEF PROCupdate 
310 CASE II OF 

320 WHEN 1 ; PROCosc(*'!Fonts") 

330 WHEN 2 : PROCosc("!System") 

340 PROCosc("!Teletext") 

350 PROCosc("Archive") 

360 PROCosc("!Utils.!Eoot") 

370 PROCosc(^lUtils.!Run") 

330 WHEN 3 ; PROCOSC("Basic") 

390 PROCosc("!Birds") 

400 WHEN 4 : PRXosc ("Stars") 

410 WHEN 5 : PRXosc ("C JCstart") 

420 PROCosc ("C. makefiles") 

430 PROCosc ("C, programs") 

440 WHEN 7 : 

450 option$=^" A -C -D F L -N -P Q 
R ~S *T 

460 PROCos c("!Viewsheet") 

470 option?^" A -C -D F L N -P Q 
R -S -T -V" 

480 ENDCASE 
490 ENDPROC 
500 ^ 

510 DEF PROCerror 

520 PRINT REPORT?" at line ERL'osell? 

530 ENDPROC 
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IMAGINE 

what your Archimedes 
would be like if we 
didn't produce over 200 
PostScript™ compatible 
high quality fonts. 


or font cataCogues, price Cists, tecfinicaC Info etc, contact 

The Electronic Font Foundry 

18, ^rocfcenfmrst I(pad, JAscot, (Beri^. SLS 9(DL 
^eCepfione (24firs) or Cfa7(: 0344 872923 



Watchdog Update 


Nick Smith adds some enhancements to our popular Watchdog Anti-Virus 
application. 


atckdog was originally published in 
RISC User Volume 3 Issue 7. Its 
purpose was to protect discs from being 
infected by viruses, by Bitering out certain 
operating system calls which involve 
writing to disc. It has proved to be a 
popular application, particularly with the 
spread of public domain discs for the 
Archimedes, and we have now updated 
the original to include additional levels of 
protection, A minor bug has also been 
fixed. 

As originally published, Watchdog 
allowed normal saving and deleting, as 
these operations are often in continual use 
while working with the computer, but 
prevented PileCore_DiscOp calls and also 
the OS_FSControl call used by *Wipe. In 
addition, a facility was provided to ‘^clean^ 
a disc, by compacting it as far as possible 
and then wiping the free space to remove 
any hidden viruses* The magazine disc 
version also offered an extra level of 
protection by preventing all write 
operations* 

This extra protection provides the 
main feature of the new version listed 
here (V2*50)* It is now possible to specify 
either partial or total protection; choosing 
the latter will prevent viruses from 
performing any operations which will 
write to your disc. A fourth option has also 
been added, which not only prevents 
writing to, but also reading from a disc. 
Thus all disc access is effectively 
prohibited. This can be useful for keeping 
prying eyes away from your files, so if, for 
example, you have confidential 
information on the disc, you can switch 
this option on if you need to leave your 
computer unattended, and be sure that 
no-one else can read the files in your 
absence. 


AMENDMENTS 

The two listings given below show the 
necessary modifications to be made to the 
original listings* Some of the lines are 
replacements for existing lines, while 
others are new lines to be added* Load the 
original IRunlmage program into Basic 
and then type in the lines given in listing 
1* Then save the whole program back as 
IRunJmage. Follow the same procedure 
with MakeWatch. It is essential that the 
line numbers of the original programs are 
exactly as listed in Volume 3 Issue 7, and 
must not have been re-numbered. 

Before you can use the new Watchdog, 
you must run MakeWatch to create a new 
WatchRM module. You will also need two 
additional sprites in the fSprites file: 
!watchdogs and !watchdog4. These should 
be the same as the existing sprites but 
with a different colour light for each level 
of protection, e*g* black for off, yellow for 
partial, orange for total and red for 
read/write* 

USING WATCHDOG 

The application is used in exactly the 
same way as before. When instaUed on the 
icon bar, the icon will reOect the current 
protection level both by the colour of the 
light and the text below* Pressing Menu 
over the icon will now display the 
following options; Nonef Partial, Total, 
Read/Write, Clean and Quit. The Clean 
option works as before, except that a small 
bug has been fixed so that discs with no 
bytes of free space can be cleaned without 
crashing. The other options are self- 
explanatory and refer to the protection 
levels described above: None allows all 
disc access. Partial prevents write 
operations apart from saving and deleting, 
Total prevents all write operations, and 
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Watchdog Update 


Read/write prohibits both reading from 
and writing to the disc* 

This month^s magazine disc contains an 
even more advanced version of Watchdog 
(V3,00)^ which in addition to the 
enhancements presented here, offers a 
number of extra features. For example, 
with protection set, it is possible to specify 
a pathname which remains unprotected; 
thus you can write to a floppy while still 
protecting your hard disc. 

Usting 1 

10 REM >ffiuAllUga 

20 REM Program Anti-Virus utility 

30 REM Version A 2*50 

40 REM Author Mick Smith 

50 REM RISC User March 1991 

60 REM Program Subject to Copyright 

70 : 

100 DIM blkl 512* DIM mrmk 228 
1200 CASE !blk% OF 

1205 WHEM 0,l,2,3:PROCProtection(!blklJ 
1210 WHEN 4:PROCClean 
1215 WHEN 5:finishedl^l 
1220 EWDCASE 

1260 DEF PROCProtection{item%) 

1270 protects-iteml 
1280 IF itenil“0 THEN 
1320 ENDIF 

1330 IF itein|=l THEN 

1340 OSCLI "Lock P" 

1341 $(bufferl+30)-"S!WatchDog3” 

1342 $(buffQrU20j=^"Watch XOn^ 

1343 ENDIF 

1344 IF iteinl^2 THEN 

1345 OSCLI "Lock T" 

1371 IF item%=3 THEN 

1372 OSCLI "Lock 

1373 ? (buff€rU30) ="S! WatchDog4’' 

1374 ? (buf ferH20) ="Watch R/W" 

1375 ENDIF 

1600 IF protect^=0 item^IO^l ELSE item% 
30^0 

1621 ${item%+12)="None"+CHRS^0) 

1622 iteml-item^+24 

1623 IF protectl=l item^30“l ELSE item! 
10=0 

1624 iteml!4-0 

1625 iteni%!e=&70090Xl 


1626 5(iteni%+12)^"Partial"+CHR$tO) 

1627 item%-item%+24 

1628 IF protectl=*=2 item%!0=l ELSE itemi 
tO-0 

1629 itein^[4-0 

1630 item^!e=&7009011 

1631 S{iteml+12)-'^Total”+CHR$(0) 

1632 item%=iteml+24 

1633 IF protectl-3 item%!0“l ELSE item% 
! 0*0 

1634 item%!4=0 

1635 item%I8=ii7009011 

1636 $ (iteml+12) -"Read/write"+CflR$ (0) 
1720 SYS "Wimp_CreateHenu'%0,menu%, (blk 

%S0)”200/2,44*8+32 
1820 $ {buffer 1+20)«"Watch XOn'^ 

1830 ${buffer%+30)-"S!WatchDog3»' 

2010 OSCLI "Lock p" 

2020 protect%“1 

Listing 2 

ID REM >Ha]mHatch 

20 REM Program Mcvdule source code 
30 REM Author Mick Smith 
40 REM Version A 2*50 
50 REM RISC User March 1991 
60 REM Program Subject to Copyright 
240 EQUS "WatchDog"+CHR${9)+"2.50 ("+M 
ID${TIME$,5rll)+") By Nick Smith"+CflR$0: 
ALIGN 

270 FMcommand ("Lock", Lock, &010001, Lock 
Syn,LockHlp) 

330 -LockSyn EQUS "Syntax: *Lock [p|t| 
rw]":EQUB 0:ALIGM 

410 LDRB Rl,[R0]:ORR R1,R1,#32 

411 LDRB RO,drives:TEQ Rl,#ASC"p" 

412 MOVZQ R0,#1:TEQ Rl,#ASC"t" 

413 MOVEQ R0,f2:TEQ Rl,#ASC"r" 

414 MOVEQ R0,#3:STRB RO,drives 

680 BIC R0,R0,#£FF:BIC R5,RO,#ii300 
730 SWI "XOS_GBPB";BVS exit_clean:SWI 
"OS_ReadEscapeState" 

1061 TEQNE Rll,#&08iTEQNE Rll,#&09 

1062 TEQNE Rll,#SOC:TEQNE Rll,#&0D 
1110 LDRB Rl2,drives:TEQ R12,#1:BEQ lev 

ell 

1120 TEQ Ri2,#2:BEQ level2:TEQ R12,#3 
1130 BEQ lev6l3:B routine 
1140 : 

1150 .levell 
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1160 TEQ Rli,R10:BtrE leveli_juitip 
1170 AND R11,R1,#%1111:TEQ Rll;#2 
1180 TEQHE R11,#4:BNE routinerBEQ error 
1190 . levs ll_j limp 
1200 TEQ nitH29iEm routine 
1210 TEQ R0,f27;BNE routinerBEQ error 
1220 : 

1230 .level2 

1240 TEQ R11,R10:BHE level2_jumpl 

1250 AND Rll,Rl,tlllll:TEQ Rll,#2 

1260 TEQNE Rll,#4:BNE routinerBEQ error 

1270 ,level2_junipl 

1280 TEQ Rll,#fi29rBNi: Ievel2junip2 

1290 TEQ R0,#27:T£QNE; R0,#2r 

1300 TEQNE RO,#25:TEQNE R0,#26 

1310 BEQ error:BNE routine 

1320 .Ievel2_junip2 

1330 TEQ Rll,#iiOD:BNE Ievel2jump3 

1340 TST R0,|i80:BEQ errorrBNE routine 

1350 .Ievel2_jump3 

1360 TEQ Rll;#i08rBNE routine:TEQ R0,#0 
1370 TEQNE R0,#1;TEQNE R0,f2;TEQNE RO,# 
3 

1380 TEQNE RO,#4:TEQNE RO,#6:TEQNE RO,# 
7 

1390 TEQNE R0,#B:TEQNE RO,#9:TEQNE RO,# 
10 

1400 TEQNE ROjllrTEQNE RO,#18 
1410 BEQ errorrBNE routine 
1420 : 

1430 .levels 

1440 TEQ Rll,RIOrBNE leveI3_jumpl 

1450 AND R11,R1,#U111:TEQ Rll,#2 

1460 TEQNE R11,#4:BWE routinerBEQ error 

1470 .Ievel3_jui!ipl 

1480 TEQ R11,#S29:BNE Ievel3jump2 

1490 TEQ R0,#27rTEQNE R0,#24 

1500 TEQNE R0;#25rTEQNE R0,#26:TEQNE RO 


1590 TEQ Rll, #((0C:BNE routinerBEQ error 
1600 : 

1610 .error 

1620 BIC R12,R14,#&FC000003 
1630 LDR Rll, [Rl2,#-4]:rST Rll,#(l«17) 
1640 BEQ generate_errorrLDMFD R13^{R10 
-R12} 

1650 ADR R0,errBlock;ORRS Rl5,R14,#fl« 
28) 

1660 r 

1670 .generate_error 
1680 ADR R0,errBloclt:MOV Ri,#6 
1690 SWI "OS_ServiGeCall":ADR R0,errBlo 
ck 

1700 MOV R9,#l:SPiI "OS CalUVector" 

1710 LDMFO R13!, fRl0-R121:M0VS PC,R14 

1720 .const EQUD AFFF20000 

1730 .filecore EQUD A40540 

1740 .errBlock EQUD filOBC9 

1750 EQUS "Protected disc":EQUB OiALlGN 

1760 : 

1770 ] 

1780 NEXT pass^ 

1790 narte$^"WatchRM’’ 

1800 SYS "OS_File",10,name$,SFFAwGodel 

,0^ 

1810 PRINT'"Module Saved as '"name?'’'/' 

I 

1820 END 
1830 : 

1840 DEF FNcommand(com?,call^flags,synt 
ax,help) 

1850 [OPT pass^ 

1860 EQUS com$:EQUB OrALlGN 

1870 EQUD call:EQUD flags 

1880 EQUD syntaxrEQUD help 

1890 ]:=0 m 


,#10 

1510 TEQNE R0,#32:BEQ errorrBNE routine 

1520 .Ievel3_jump2 

1530 TEQ Rll,#i0D;BNE level3_jump3:BEQ 
error 

1540 .Ievel3_juifip3 

1550 TEQ Rll,#i0e:ENE level3_jlimp4 : BEQ 
error 

1560 .Ievel3_jump4 

1570 TEQ R11,#409:ENE level3Juinp5rBEQ 
error 

1580 .level3_jump5 


Skyfall Public Domain 

The Worbls Lar|eut ArcMmeUcs PtibUc t^omatn 

SkyBill has virtually every bit of PD ever wrinen or 
drawn for the Archimedes, well in excess of 200 discs, 
Slacker, Galleries, Colour Digiiizaiions, Applications, 
Games, Ray Traced, DTP Clips and Spriies, Me®a 
-Samples and the list goes on. All available at between 
i2.50 andil.50 depending on quantity ordered 

Send a £1 coin for our demo disc, 
or send an SAE for the printed catalogue. 

Skyfaii PD^ 93 Jsryshaw Avenue, 
Blrmlnghatn, B43 5RX. 
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Bases DBMS 


Alan Wrigtey reviews a new programmable rfmtabase for the Arc. 


B aseS DBMS was first shown to the 
public at the BBC Acorn User Show 
last September. There are already, of course, 
a number of databases on the market for the 
Archimedes, some of them multi-tasking, 
and so the first question to ask is: “What 
makes BaseS difTerent from the rest?" 

The answer is that Base5 has been 
designed from the outset as a programmable 
database, to be used by software developers 
as a basis for their own database 
applications, rather than a front-end 
database manager with a programming 
language tacked on. A multi-tasking Wimp 
front end has been supplied with the 
database, but the real scope of this package 
lies in the powerful set of Basic procedures 
and functions which will allow any 
competent programmer to design a database 
to Ms or her own specification. 

THE PACKAGE 

Base5 DBMS comes on a single disc, 
together with a ring-hound manual. The 
package 1 used for review also had a 
supplementary manual covering the multi¬ 
tasking front end and procedures which 
were not present in the original version, 
though these may be combined into one 
manual in the future. On the disc are a 
multi-tasking database application, 
WimpBaseSf together with some sample 
database files including one of English 
monarchs which is used to provide examples 
throughout the tutorial section of the 
manual. Also on the disc are the libraries of 
procedures and functions which form the 
heart of the package. The main library 
contains some 80 procedures and 57 
functions which provide all the file and data 
handling facilities, while separate libraries 
contain procedures for mathematical 
functions, reports, and “relate" files, which 
allow a relational database structure to be 
created. Finally, the disc contains a line 
input module to handle keyboard input. 

Extensions to the system are planned, in 
the form of add-on libraries and utilities. 
For example, the latest developments, which 
should be available by the time you read 
this, are an advanced maths library, and a 


library to process data representing co¬ 
ordinate pairs, complete with an application 
which writes mouse co-ordinates directly 
into database fields. Also available to 
registered users is a technical Journal called 
ForumS, intended to he a focal point for 
advice, comment etc. 

LIBRARIES 

The libraries form the core of the BaseS 
system, and cover more or less every 
conceivable action you might want to 
perform. Each procedure and function is 
fully documented in the manual, with 
details of parameters required, actions 
taken and values returned when called. 
There are facilities to create, open and dose 
databases, to add or delete fields and 
records, to browse, search and sort, and so 
on. Many functions can be made conditional, 
either on comparison tests, as in the case of 
searching, or on certain flags which can be 
set or reset- for example, the use deleted flag 
determines whether deleted records are 
included in a search, while the exact flag 
determines whether string comparisons 
should be case sensitive. 

One particularly attractive feature of 
Base5 is that fields can be added, deleted or 
modified (e.g. by changing their length) even 
if they contain data. Most of us have had 
experience of setting up a database and 
spending many hours entering data, only to 
find that the field structure we defined at 
the start doesn't cater for all eventualities. 
With many databases, the only solution is to 
start all over again firom scratch, but with 
Bases this need never happen. You do of 
course have to be careful when modifying an 
existing database structure, but on balance 
the flexibility this gives is more important. 

STRUCTURES 

When setting up a database, the 
maximum number of channels, fields per 
channel and records per channel must be 
si>ecLfied. Obviously there will be a trade-off 
between the sizes specified and the memory 
available in the machine. The manual gives 
some guidance on how to calculate the 
memory requirements for a given 
configuration. The abiKty to have more than 
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manipulate databases using the calls 
documented in the manual, adding your own 
code to perform the functions of the program 
which do not directly involve handling files 
or data. 


adfs: :8as»S.S.£jt4ivles.Sp4ceU8 
M»Md Srut Hithts mi ta im 
3 af 113 


pusnoHIUTl C Trrtslifcava 


piisiMSttm c 
aS7MniIT4 c 
«STB0iIlin3 c 
usiiMiine c 
fisnoiiifn c 
pnssidl C Vast ok I 
SEUES C VOSTOC 
LBOICOBII B li OS 13S3 
BOUTIOl C 2d 2211 3 Dh 
COO miV C V5SI 
CttnCFI C First MRaa 


WImpBaseS being used with reiated fiies, 
showing both parent and chiid windows open 
on the Desktop 

I must make it clear to anyone who might 
think that this provides a ready-made short 
cut to a complex database program, that a 
considerable amount of work is still involved. 
Base5 will deal with things such as opening 
and closing files; retrieving, editing and 
saving records; searching, sorting etc. 
However, it is up to you to write all the 
screen-handling routines, menus etc. (which 
means the entire Wimp interface if it is 
multi-tasking), and also the code to decide 
what to do with keyboard input, how to 
interpret the information in the database and 
so on. The advantage of this, of course, is the 
extreme flexibility it gives. The appearance of 
the database, and the way it interacts with 
the \iser, are entirely up to you. 


FRONT END 

WimpBaseS is, as its name suggests, a 
multi-tasking front end for Base5. It is 
provided to enable the package to be used as 
a database by those who do not wish to 
write their own applications, or as an 
example for those who do. Although it is 
intended for serious use, it is not the main 
reason for the existence of Base5, and this 
should be taken into consideration when 
comparing it with other database systems 
on the market. 
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Aleph One Ltd, The Old Courthouse, Bottishcim, CAMBRIDGE 
CBS 9BA Tel (0223) 811 679 Fax (0223) 812 713 




Bases DBMS 


The application itself conforms to the 
usual format for Wimp programs, with a 
main window in which the records are 
displayed, and a comprehensive menu 
structure which allows pretty well every 
standard database function to 1^ performed. 
For example, file manipulation includes 
open, close, discard or recall facilities; fields 
can be added, deleted or modified and so on; 
records can be added, deleted, edited, sorted 
etc. Search facilities are included, as are 
import and export using the formats 
described above, with facilities to make 
export conditional, by specifying either a 
range or a set of conditions. A Reports 
Designer is also built in, to allow you to 
print information from the database. 

An additional feature is the ability to 
relate files. Two or more files can be linked by 
a relate file; this describes which fields in the 
parent file are to be linked with which in the 
child. The manual describes clearly how to do 
this. Once the links are set up in this way, if 
a field from a parent file displayed in the 
main window has a related field in a child 
nie, a second window is opened to show 
information taken from the child field. 

WimpBasefi performs competently, and 
can be used by anyone who wishes to set up 
and use a simple database with the 
minimum of effort. Indeed, there are a good 
many users who bemoan the complexity of 
some databases, and for many applications 
the uncomplicated but comprehensive 
facilities provided by WimpBaseb will be 
welcome. I had some small niggles about the 
way certain things had been done. For 
example, in a database of, say, 100 records, 
the first will be shown as “Record 0 of 100” 
and the last as “Record 99 of 100”. However, 
the author of the package is receptive to 
comment and suggestion, and is continually 
making refinements in the light of feedback 
(1 understand that the criticism mentioned 
above will be dealt with, for example). 

For those who buy this database with a 
view to developing their own applications, 
WimpBaseS will also prove a very useful 
tool. It appears to be robust, and is ideal for 
creating and testing data structures while 
developing an application to handle them. I 
tried this out myself, using WimpBaseS to 
create a database of my photographic slides. 
Once I was satisfied that the data structure 


was correct, I then started to write a multi¬ 
tasking application to display and handle 
the information in a format more suited to 
my own requirements. This is a task I have 
been meaning to do for many years, but it 
has taken the arrival of RISC OS and BaseS 
to give me the confidence to tackle it. The 
result was very satisfactory: the BaseS 
procedures worked as they should and did 
everything expected of them. The system is 
complex, but no experienced programmer 
should have difficulty in understanding it. 

CONCLUSIONS 

This package makes a valiant attempt to 
give the Archimedes a truly programmable 
database, which can be used by software 
developers to create professional, possibly 
application-specific database systems, in 
much the same way that, in the PC world, 
programmers often build systems using 
Dbase, for example. Given the p>ower of the 
Archimedes, it is not difficult to envisage 
that some imaginative programming and a 
little enterprise could make the Arc worthy 
of consideration in some areas where a 
tailored system is needed, such as hotel 
management or doctors' surgeries. 

This is the theory, at any rate. My only 
reservation is that, in trying to cater fairly 
and squarely for the average Archimedes 
programmer, Base5 is written in Basic. 
Rightly or wrongly, Basic is not generally 
seen in the computer world at large as a 
suitable language for writing major 
applications, though thankfully Base5 is at 
least fully compatible with both Basic 
compilers. Indeed, it is more difficult to 
write Wimp-based programs on the Arc in 
Basic than in C, for example, though 
certainly not impossible. My fear is that this 
will discourage the very people at whom 
Base5 should be aimed: programmers 
experienced at writing applications on other 
systems who see the Arc market as an 
exciting and worthwhile new venture. I hope 
this will not be the case, because we 
desperately need more powerful and 
professional business software for the Arc to 
make its presence felt in serious circles. 

Product Bases DBMS 

Supplier BaseS 

PO Box 378 

Woking. Surrey GU21 4DF. 

Price £69.00 inc. VAT. :rf f j 
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Creating Professional Disc 
Labels with Draw 


by Majid Anwar 


W ith RISC OS'fi excelleEit printer 
drivers, making labels for your discs 
is simple. This article explains how to 
produce professional looking labels with 
relative ease^ using the basic packages 
provided on the RISC OS Applications discs, 
coupled with any printer ranging from a 
humble dot-matrix right up to a powerful 
PostScript machine. 

MATERIALS 

In addition to your Archimedes, youll 
need a printer (but see later), the Draw 
application (on the Appl disc), a printer 
driver (also on Appl), and something to 
print on. You might also want to use Paint 
(Appl again), but more about that later. The 
label itself can be made from any of the 
following, depending on your time and 
finances: 


over the top-left node using the Adjust 
button, and then Select Enter coordinates 
from the menu, A small window should open 
up displaring the co-ordinates of the node 
relative to the bottom-left of the page. Select 
the centimetre option and replace the co¬ 
ordinates shown with x=1.0 and y:=l,0 and 
then click on OK. Do the same with the 
other three such that top-right = (8,0, 8,0); 
top-left = (1.0, 8.0) and ^ttom-right = (8.0, 
1.0), You should now have a rectangle 
measuring 7cm by 7cm: the exact sixe of a 
3,5” disc label (it may not look this size on 
screen). This is the basic label outline in 
which any design may be placed. Fig.l 
shows the dimensions for some landmarks' 
on a standard disc label. You can place and 
size them precisely using the co-ordinate 
method explained above. 


1. Plain paper with: 

a. double-sided tape 

b. ruh-on adhesive (e.g. Pritt) 

c. spray-on adhesive {e,g, UHU) 

2. An A4 ^sheet labor e.g. Canon 

Copystock or Cmckback 

The advantages of the former option 
are that it's cheap, and tinted paper can 
also be used. The latter, although more 
expensive, is simpler to use and less 
messy. Finally, you might like to use 
some clear sticky-backed plastic/ 
cellophane to cover the finished label, 
giving it a glossy appearance. This is 
especially useful if you are using a water- 
soluble inkjet printing system. 



ngur& r. A 'standard' 3.5 incn disc labsi; 
all measurements are in cms (the "spine" is 
another rectangle) 


CREATING THE LABEL FILE 

This section assumes that the user is 
familiar with both RISC OS (i.e. use of the 
pointer, dragging , etc.), and the Draw 
application. Remember to save your work 
regularly during this session. Start with a 
new document in Draw and create any 
rectangle somewhere on the page. Now, 
resize this precisely, thus: 

Select the rectangle to edit it. The 
rectangle will be replaced by 4 blue nodes at 
the comers connected by 4 grey lines. Click 


Copy the outline and place several on 
the page, but remember to stay away from 
the edge, as your printer will probably have 
a margin in which it cannot print. Load 
your printer driver (see below) and choose 
show printer margins from the Draw Misc 
menu to see the border. You can now 
proceed to design your disc label using all 
the features of Draw (see example in Fig.2), 
but make sure any fonts you need have 
been installed first. 

Continued on page 28 
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See your free memory at a glance with this application from Maiid Anwar 


I n order to see the amount of free 
memoiy left in your Archimedes, it is 
normally necessary to open the Task 
display window from the Task Manager 
(the A-shaped icon at the right of the icon 
bar). The total amount of free memory is 
made up of the Next and Free slots shown 
on the Task display* 

FreeSlots enables you to see this 
information continuously updated on the 
icon bar, without needing to open the Task 
display window* It works by first replacing 
the Task manager icon with a new icon 
consisting of a blank sprite, and then 
redirecting VDU output to this sprite to 
display the values of the Next slot and the 
total free memory (i*e. Next + Free). 


USING THE APPLICATION 

Double-clicking on the !FVeeSlots icon 
in a directory viewer will install the 
application, and after a short pause you 
will see the Task manager icon change to 
display two figures in place of the usual 
icon. The upper figure, in red, shows the 
current value of the Next slot, while the 
lower figure, in green, shows the total 
amount of free memory. As you install or 
remove applications you will see the 
figures change. As well as displaying this 
information, the new icon still performs 
the sarne function as the A-shape it 
replaced, so you could open the Task 
display window and see what happens as 
you drag the Next slot up and down with 
the mouse. 


CREATING THE APPLICATION 

First create an application directory 
called IFreeSlots, This will require a 
suitable application sprite, contained 
within a !Sprites file, and also a !Run 
Obey file with the following lines^ 
iconSprites cObey?Dir>.!Sprites 
wimpSlot -min 8K -max BK 
Run <Obey$Dir>.1Run Image 
If you are unsure how to create an 
application directory the simplest method 
is to use our Application Shell Generator 
(Volume 3 Issue 2 or Volume 3 Special 
Disc), 

Next, type in the listing given here and 
save it in the application directory with 
the name fRtinlmage. Finally, you need a 
blank sprite to replace the Task manager 
icon sprite. Using Paint, create a sprite of 
width 38 and height 17. Fill this 
completely with colour 1 (light grey), 
name it switcher, and save it in a separate 
file in the application directory. For 
convenience you can also call this file 
Switcker^ but it can have any name 
provided that you alter line 120 of the 
program to reflect the name you choose. 


You can only remove the FreeSlots 
application from the Task display window. 
Tb do fiiis, click Menu anywhere along the 
line occupied by FreeSlots in the 
Application tasks section of the window, 
go to the submenu for the task, and select 
Quit. The original Task manager icon will 
now he restored to the icon bar. 


10 KEM 

20 F^M Program 
30 REM Version 


>JRuxlXisag« 

Free slots 
1.00 


40 KEM Author Majid Anwar 
50 KEM RISC User March 1990 


60 REM Program Subject to copyright 
70 : 


60 OH ERROR PROCerror:EHD 
90 DIM q| 255 
100 quitl=FALSE 

110 SYS ''Wimp_Initialis6",200,fc4B53415 
4; ’’Free slots" 

120 *Iconsprites <ObeySdir>.switcher 
130 : 

140 REPEAT 

150 SYS "Wimp Poll", Ulllllllllll0,q4 
TO reasonI 

160 CASE reasoni OF 
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170 WHEN 0 : PROCupdatesprite 
180 WHEN 17,18 r quit%-E16=0) 

190 ENDCASE 
200 UNTIL quiti 

210 SYS "Wimp_BaseOfSprites" TO ,ramsp 
r| 

220 SYS "0S_Sprite0p'M119,ram3pr^, ^sw 
itcher" 

230 !q^=4:q%!4=5:q%!0=ll 

240 q^E12=l2:q^tl6—1 

250 SYS "OS_ReadVdluVariables",q%,q|+32 

260 x^=ql!40*2^q^!32:y^=q^!44*2^ql!36 

270 SYS "Wiinp_ForGeKedraw",-I,0, 

% 

280 SYS ’■Wiinp_CloseDown" 

290 END 
300 : 

310 DEFPROCupdatesprits 
320 SYS’’Wimp_SlotSiKs",-l,“l TO , next^ 
, free% 

330 IF nextl>freel nsxtWree^ 

340 SYS ’'Wijiip_BaseOfSprites" TO , ramsp 


rl 

350 SYS "OS_SpriteOp^, &l3C,r^sprl, "sw 
itCher" TO R0,R1,R2,R3 
360 GCOLl:RECTMGLEFILL 0,0,76,64 
370 GCOLll 

330 PROCprifit (STR$ [next%/10245+"K", 60) 
390 GCOL13 

400 PROCprint<STR${free%/1024)+"K",2a) 
410 SYS "OS_SpriteOp",R0,Rl,R2,R3 
420 ! ql—1: ql! 4-0: q% 18=0: q% 312=0 
430 SYS "Wimp_SetIconState",,q% 

440 ENDPROC 
450 : 

460 DEFPROCprint{a$,y^) 

470 VD05;MOVE 36“LENa$*a,v?-PRIWTaS 
480 ENDPROC 
490 : 

500 DEFPROCerror 
510 ON ERROR OFF 
520 SYS "Wimp_C10seDown" 

530 PRINT REPORr$" at line ";ERL 
540 ENDPROC * 


Creating Professional Disc Labels with Draw (continued from page 26) 


The nfie of sprites deserves special 
mention: sprites can be dropped directly on to 
a Draw document but can only be modified 
within Paint. An application’s own sprite 
may be loaded by pressing 
Shift while double-clicking 
over the application and 
loading the ESprites file into 
Paint. The relevant sprite 
(and maybe others) will 
appear in a window. Choose 
the sprite and ensure the 
Palette option {in the Edit 
submenu) is on. Now, save 
this sprite (not the whole 
file) and drag it onto the 
Draw window. Position and 
size it as required. 

PRINTING 

There are three ways to print your newly 
created disc label* Firstly you can print it 
yourself. Remember to turn the 
Monochrome option off if you are using 
colours or sprites. Secondly, you can take 
your file to another Archimedes (perhaps 
with a better printer) and print it there. 
Finally, and most ambitiously, you can use 


PrinterPS - the PostScript driver. Set this to 
^file’ output (as opposed to parallel or serial) 
and enter a path to where you want the 
printer driver to create its file* Now print as 
normal and a PostScript 
file will he created* Finish 
off by selecting parallel or 
serial again. This 
PostScript file can be taken 
to any PostScript 
compatible printer in¬ 
cluding powerful photo- 
typesetters at your high 
street printing shop. First, 
however, use an IBM disc 
reader (for example, PC 
Disc Reader from the 
Volume 3 Special Disc) to 
copy the file onto an IBM 
disc (which is the industry 
standard for these professional machines). 
Of course, if you have your own PostScript 
printer, the quality of its printing may be 
more than good enough for your needs. 

Other labels can be produced in a similar 
way (e*g. 5” discs, videos, cassettes etc.), all 
with the same professional result. (FI& 



Figure 2. Samote 3.5" disc tabeJ 
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Canon BJ-lOe Printer 


Alan Wrigley looks at Canon's new baby bubble jet. 

A t first sight the Canon BJ-lOe looks they are potentially more reliable since 

/^improbable. Measuring just 12 x 8.5” there are no moving pins to wear out or 

(the same size as an A4 sheet of paper) become damaged. And thirdly, print 

and about 2” thick, it would easily pass for density is consistent throughout the life of 

a smart software package. Yet the BJ-lOe the ink cartridge. Compare this with a dot 

is an 80-column bubble jet printer which matrix, where the print might be black for 

lacks none of the features normally found the first few pages with a new ribbon, 

on full-size machines. then becomes an increasingly lighter 

shade of grey until you decide you can’t 
read it any more. The main disadvantage 
is the cost of the ink cartridge, which 
works out around 4p per sheet, compared 
with about l-2p for a dot matrix printer 
(depending on how often you change the 
ribbon!). 


THE PRINTER 

The BJ-lOe looks very smart, and is 
available in two colours, mid-grey (called 
black) and beige (called white). As well as 
being small, it is also very light in weight 
(about 4 lbs, or less than two bags of 
sugar). This has been achieved partly r 
by the use of very light plastic for the 1; 
At first sight this appears to be t 


case, 

extremely flimsy, and flexes alarmingly, 
giving the impression of poor quality. 
However, this is quite deliberate: the 
printer has been designed first and 
foremost with portability in mind, and a 
flexible casing is less likely to be 
damaged if dropped or knocked in 
transit. 


The BJ-lOe is powered either from a I 
separate mains adaptor (which is I 
supplied) or from batteries which fit I 
into the rear of the machine. An ■ 
optional NiCad battery pack is available 
for the latter purpose. This enables the 
printer to be used virtually anywhere and 
thus makes it the perfect companion for a 
laptop portable computer, while still 
offering all the facilities required of an 
office printer. A parallel Centronics 
interface is fitted as standard. The 
package is completed by a slim User’s 
Manual. 


The BJ-lOe in horizontal mode 


THE BJ-lOe IN USE 

The first thing to be aware of when 
using this printer with an Archimedes is 
that you will need a RISC OS printer 
driver which supports the BJ-lOe. 
PrinterDM can do this, but only if the BJ- 
lOe is included in the list of printer 
definitions. BEEBUG can supply a version 
of PrinterDM suitable for the BJ-lOe 
(which is free if you buy the printer at the 
same time). If you are using the BJ-lOe 
with applications which print without the 
aid of the RISC OS drivers, you may have 
a few problems since, although many of 
the printer codes used by the Canon are 
Epson-compatible, not all of them are. For 
example, italics are not supported, and 


The bubble jet technology is a Canon 
speciality. It is similar to that of other ink 
jet printers except that the ink is expelled 
by heating a bubble which forces the ink 
out, rather than by spraying. Ink jet 
printers have three main advantages over 
dot matrix printers. Firstly, they are 
extremely quiet in operation. Secondly, 
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Canon BJ-10 b Printer 


international character sets are treated in 
a different way, which makes it well nigh 
impossible to obtain a pound sign when 
printing text files (though if you have 
PrinterDM version 2*44 this can be cured - 
see the review of the new printer drivers 
in Volume 4 Issue 3)* In fact, the manual 
suggests the IBM Proprinter X24E as the 
nearest equivalent. The manual gives 
little information about printer codes, 
other than to simply list them* However, 
Canon does supply a Programmer’s 
Manual <£S*00) for those users who need 
to delve more deeply into the subject. 



The BJ-lOe in verticBi nio<ie 


The printer can be used either 
horizontally or vertically (see photographs). 
In horizontal mode the open printer case 
acts as a guide and support for the paper, 
which is fed in from the top like a 
conventional printer When used vertically, 
the paper is fed into a slot in the back. This 
is useful for printing envelopes and other 
thick items which will not go through the 
necessarily tight path which is a 
consequence of the small roller. Since the 
case has to be open for the paper to emerge 
(and thus must He flat in front of the 
printer), there seems to be little space 
advantage in using it vertically, until you 
realise that this is a clever way of providing 
a compact auto sheet feed facility. An 
optional auto sheet feeder, not much larger 
than the printer itself, fits onto the rear of 
the BJ-lOe in the vertical position and 
feeds the paper through the rear slot. 


PERFORMANCE 

To assess the performance of the BJ- 
lOe, I compared it directly with a good- 
quality dot matrix printer, the Star XB24 
(see the review in Volume 3 Issue 9), and 
with the HP DeskJet 500, a popular ink 
jet printer costing more than the BJ-lOe 
and about six times the size. For interest, 
I also compared it with the Qume 
CrystalPrint Publisher, which is a 
PostScript printer. I chose two Draw files, 
one of which I have used before in 
comparative tests (e.g* the LaserDirect 
and the ArcLaser, Volume 3 Issue 8 and 
Volume 4 Issue 1 respectively). The 
picture is of a plant, and contains areas of 
shading in various densities, including a 
block of dense colour. The other file was a 
technical drawing containing a lot of fine 
detaO, Both these files were printed at 
360x360 dpi on the Canon and Star, and 
300x300 dpi on the Qume and DeskJet. 

The results of the tests took me 
somewhat by surprise. The output from the 
Qume was crisp and sharp, as would be 
expected, though with natural subjects, 
such as the plant, the clinical halftone dot 
patterns do not necessarily enhance the 
subject. With the technical drawing, some 
of the fine lines were far too thick and bold, 
degrading the image in some places. The 
DeskJet coped with fine lines admirably, 
and reproduced both pictures to a high 
degree of precision. However, I felt that the 
plant stiU lacked life, and the lines on the 
technical drawing looked a little weak 
(though for veiy intricate work this would 
be an advantage). The BJ-lOe, on the other 
hand, produced superb results from both 
files, and I have to say that, subjectively, I 
preferred the output to both the Qume and 
the DeskJet. Fine lines were crisp and 
clear, while dense areas were admirably 
reproduced as a solid block of colour. 

The XB24, as might be expected, was 
not in the same league, producing a result 
which was unmistakably from a dot matrix 
printer, though better than many. The tell¬ 
tale horizontal lines and slightly crinkled 
paper, which are the result of impact by the 
printer pins, were particularly noticeable 
across the plant. Surprisingly though, the 
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XB24 was faster, reproducing the plant in 2 
mins 55 secs os opposed to 4 mins 50 secs 
for the BJ-lOe and 3 mins 25 secs for the 
DeskJet 500 (the Qume, being a postscript 
printer, is in a different league in terms of 
speed, producing the same printout in 
around 50 secs). 

Text printing on the BJ-lOe is 
reasonably fast (83 cps is claimed) and 
produces an attractive and crisp result in a 
Courier font. The only other fonts available 
are Prestige elite and proportional spacing, 
though since the standard Epson codes are 
not used for these, it will be difficult to 
make use of them. However, more and 
more applications are taking advantage of 
the RISC OS drivers, so the lack of fonts 
built into the printer should not worry 
most Archimedes owners. 


of consideration. Indeed, if portability or 
silent operation are important to you, and 
if you do a lot of graphics printing and 
find the image quality from a dot matrix 
unacceptable, then the BJ-lOe is probably 
the best dhoice on the market at present. 
It is cheaper than other ink jet printers, 
and a lot cheaper than a laser printer, yet 
the print quality is virtually as good as 
both of these. Canon has a real winner 
here, and provided that you plan to use it 
primarily with a RISC OS driver, then I 
can strongly recommend it. 

Product: BJ-10s bubbfs jst pdntsr 

SuppBor: Csnon (UK) Ltd. 

Canon Houss, 2 Manor Hoad, 
Waitlngton, Surrey SM6 OAJ. 

T&k 081-773 2172. 

Price: £333.45 inc. VA T 

(BEE8VG rataii price). 


CONCLUSIONS 

If you think printers should look big 
and hunky, then the BJ-lOe is not for you. 
But if you have no such pre-conceived 
notions, then it is most definitely worthy 


A version of PrE/ifcrZ>M suitable for the 
EJlOe is amiiable from BEEBUG, costing 
£17.25 inc. VAT (supplied free when you 
buy the printer). Tfii auto sheet feeder is 
also available at £62 JO inc. VAT. 



Cambridge International Software Ltd 
ARCHIMEDES SPRING FAIR 


March 9* & 10‘^(Sat & Sun) 1991 

10 am-5 pm rr—- 1 

,—^- 1 Acorn 

Minerva | at ^ -v— 

[^n^pestahe Software! ^ HERBRAND ST \riS 

\ LONDON WCINIHZ 

—^ lOO's of Archimedes products - Hardware, Software, 

—Consumables, Demonstrations, Seminars 
Digital Services I Educational software for all levels n 
I Open to dealers and the public \ 




071 833 4023 
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42M Removable Drives - £585 

If you are looking for a hard drive for your Archimedes or ASOOO, why noi consider using a 

MicroNet MR45 removable hard drive 

• Fast - The average access time is 25 milliseconds^ so these are FAST devices. When used 
with an Oak SCSI card, the file transfer rate is the same as a standard 45M hard drive. 

• Reliable -The technology of these drives has been proven by use in huge quantities on the 
Apple Macintosh computers, 

• Robust - The discs, when not in the drive, are extremely robust. We (deliberately!) threw 
one half-way across the office, it dropped on the floor and rolled over a couple of times. We 
then verified it and found that it did not have a single error on it! 

• Flexible -The medium is removable, so you can use different discs for different uses, each 
with its own boot file “ one for DTP, one for games etc, 

• Physically secure - The medium is removable, so you can take out the disc and lock it up 
in a safe place, 

• Secure data -The discs can be write protected, like floppy discs, to protect the data. 

• Cheap - The price of the drive, including a single 42M disc, is just £585 (£680 including 
VAT and carriage). Extra 42M discs are £80 each (including VAT & carriage). 

Public Domain Software 

Norwich Computer Services has a range of over 40 discs of Archimedes public domain 

softwarefrom various sources. Many of the discs contain several quite substantial applications 

for as little as £350 per disc. Some of the more popular applications are... 

• ! PC Dir - A desktop utility that allows the transfer of files between MS-DOS discs and 
Archimedes discs, (One of many programs on Careware - £7. The aim of Careware 
discs is to raise money for charity. For each disc, £6 is sent direct to charity,) 

• ! Transit tor - This application aliows you to translate between various image fi le formats 
- sprite, GIF, TIFF, (Shareware N®21, £3.50, which also has other graphics applications.) 

• ! D r a w + is an u pdated versi on of \ Draw wi th many extra features i nclud ing key bo ard short¬ 
cuts. (Shareware N- 34, £3.50, which also has !Draw lineart and other DTP utilities,) 

• Keystrip printer - Creates! Draw keystrip from an lEdit file of the text. (Shareware bP32, 
£3,50 - also has a lot of other DTP stuff on it.) 

• YAIG - Yet Another Invade rs Game - ex ceOent imp lementation. (Share ware N-16, £3.50) 

• DOS filing system and DFS reader/writer - These are available on Shareware N-31, 
£3,50, which also has a 'C’ editor and various odier utilities. 

Ring, write or fax us if you want a full list of our FD software. 

Norwich Computer Services 

96a Vauxhall Street, Norwich NR2 2SD. (0603-766592 / Fax 764011) 








Programmer’s Workshop — 

Understanding E^Format Discs (Part 2) 

David Spencer continues his took at the structure of RfSC OS E-fotmat 
discs. 


In last month's article we took a look 
at the principles on which E-format discs 
are based, and looked at the layout of the 
bitstream map that indicates what each 
chunk of disc storage is used for* In this 
article we will finish looking at the map 
by showing how its checksum is 
calculated, and then move on to look at 
the layout of the directory tree. Finally, we 
will study the allocation strategy that 
RISC OS uses to ensure the minimum 
amount of file fragmentation, and the 
fastest possible access to files. 

THE MAP CHECKSUM 

As you will remember from the layout 
of the disc map given in the previous issue, 
the first byte of each map zone contains a 
checksum for the zone. This is used to 
detect any corruption of the map, which is 
handled in a manner described later. 

The checksum of a zone is calculated 
by effectively adding together the values 
of all the words in the zone, excluding the 
checksum byte itself. The arithmetic is 
performed modulo-32, with any carry 
being added back in. Below is a suitable 
algorithm in pseudo-code. 

Point to end of map 
Zero Carry and Total 
REPEAT 

Bead 32-bit Word from map 
Total - Total + Word + Carry 
IF Total >= 2^32 
Total = Total - 2''32 
Carry = 1 
ELSE 
Carry = 0 

UNTIL all words tn zone read 
Subtract old checksum from Total 
Split checksum word into four bytes 
Exclusive OR four bytes together 
to give checksum 


This month's magazine disc contains 
an assembly language implementation of 
the above algorithm. This should be called 


with register Rl pointing to the start of 
the map zone in memory, and R2 
containing the length of a map zone (in 
bytes). The routine exits with R14 
containing the single byte checksum. The 
routine can also be used to check an 
existing checksum with the result being 
returned in the Z flag. If the Z flag is set 
then the checksum for the zone is correct. 

Because corruption of the disc map 
would effectively render every file on the 
disc unreadable, RISC OS takes 
precautions to prevent corruption of the 
map, which could easily occur if the 
computer was reset while updating the 
map. What is done, is to keep two adjacent 
copies of the map. Normally, RISC OS only 
reads the first copy, but will write both 
copies whenever the map is updated. The 
’^Checkmap command checks the integrity 
of the map against the actual disc contents, 
and if it is corrupt allows you to overwrite 
the first copy with the second. 

THE DIRECTORY STRUCTURE 

Having looked at the map struture, we 
can now move up a level and examine the 
format of the directory structure. We will 
primarily look at the directory structure 
used on E-format discs, though the only 
difference between this and D-format is 
that the latter contains the absolute disc 
addresses of files, while the former holds 
file numbers instead. The directories used 
by the obsolescent L-format are different, 
and will not be examined. 

On E-format discs, directories are 2048 
(&S00) bytes long. This means that they 
occupy two sectors on a floppy disc, and 
usually eight on an ST506-type hard disc. 
Within a directory, any sub-directories are 
simply treated as 2048-byte files, with a 
special bit in the directory entry set to 
indicate that it refers to a sub-directory 
and not a normal file. 
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The layout of data within a directoiy 
is: 


Offset 

Contents 

0 

Master sequence number 

1-4 

Directory identifier 

6-30 

First directory enby 

31-56 

Second directory entry 

1961-2006 

Final directory entry 

2007 

0 (end marker) 

2008-2009 

reserved 

2010-2012 

File number of parent 

2018-2031 

Directory title 

2032-2041 

Directory name 

2042 

Master sequence number 

2043-2048 

Directory identifier 

2047 

Directory checksum 


As you can see^ the bulk of the 
directory is made up of the 17 possible 
entries, with a header at the start, and 
additional information at the end. If less 
than 77 entries are presentj the end of the 
list is marked by a zero byte in what 
would be the first letter of the next 
filename. The directoiy identifer is the 
text string 'Nick* {after the programmer 
responsible), and is used to check that it is 
indeed a directory. The master sequence 
number^ which also appears twice in the 
directory is a value which is incremented 
each time the directory is dianged. If the 
two copies differ, the directory is deemed 
corrupt, and a ‘Broken Directory* error 
given. The directory checksum is similar 
to the map checksum, but the calculation 
is more complicated. An assembly 
language program to calculate and check a 
directory checksum is given on this 
month’s magazine disc. 

The file number of the parent is used 
for *Up, or ^ in a pathname to locate the 
parent. The directory title is a nineteen 
character long string set by *Title, while 
the directory name is the leafiiame used to 
represent the directory in the parent. Both 
of these are displayed when a directory is 
catalogued. 

Each directory entry itself consists of 
twenty-six bytes, organised thus: 


Offset 

Contents 

0-9 

Filename 

10-13 

Load address 

14-17 

Execution address 

18-21 

Length 

22-24 

RIe number 

25 

Attributes 


The ten-character filename is terminated 
with a carriage return if shorter than the 
maximum length. Most files under RISC 
OS will be date stamped and typed, rather 
than having absolute load and execution 
addresses. In this case, the load and 
execution address fields are replaced by 
&FFFtttdd and &dddddddd respectively, 
where ttt is the filetype, and dddddddddd 
is the time in centiseconds since the start 
of the century. 

The file number was explained last 
month, and consists of the file number 
proper and possibly a sector ofiFset within 
the cluster. Finally, for the directoiy entiy, 
the atrributes byte indicates the access set 
by ^Access, and also whether the entry 
refers to a file or a directory. The meaning 
of each bit is: 

Bit 0 Set for R access 

Bit 1 Set for W access 

Bit 2 Set for L access 

Bit 3 Set to indicate a directory 

The root directory, $, is always grouped 
together with the two copies of the map to 
form file number 2. For example, on a 
floppy disc, where each map copy takes 
one sector, the file number of the root 
directory is &203, meaning the third 
sector in cluster number two. Having 
located the root directory, it is a simple 
matter of scanning its entries to locate the 
files contained within it, and the sub¬ 
directories. This can then be applied 
recursively to the sub-directories, meaning 
that having located the root, any file in 
the directory struture can be located. 

ALLOCATION STRATEGIES 

It is all very well defining the 
representation of the disc map and 
directory structure, but one important 
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topic we have not considered yet is how 
RISC OS allocates the storage space on 
the disc. 

In pre E-format discs ^ the allocation of 
disc space was simple. Each time a new 
file was saved, the operating system 
searched through the map until a large 
enough block of free space was found. Any 
gaps formed by deleting files remained as 
gaps until filled by a new file of the same 
length or shorter. This system has two 
major drawbacks. Firstly, if an attempt 
was made to extend a file that was 
trapped between two others, then nothing 
could be done if the space was not 
available, and the operation was aborted 
with an error, lb avoid this, files created 
for random access were allocated vastly 
more space than they would probably 
need, in order to give the file room to 
expand. For example, RISC OS ADFS 
used to allocate 64K for each random 
access file when it was created. 

Secondly, when saving a file no attempt 
was made to minimiBe fragmentation of the 
disc space. For example, if a 15K file was 
deleted, and a 14K one saved immediately 
after, the new file would probably fit in 
place of the old one, leaving a small IK 
fragment that would only be filled if a file 
shorter than IK was then saved. This 
quickly led to the disc becoming 
fragmented, and the ‘Compact command 
was needed to tidy it up» 

E-format discs are entirely different 
with a different allocation strategy. For 
one thing, as we saw last month, files can 
be fragmented into a number of sections if 
need be. This means that there is no 
longer a need to over-allocate space when 
creating a random-access file. However, 
this leads to more problems, because if not 
managed properly you quickly end up 
with a large number of fragmented files 
that take longer than necessary to access. 

For this reason, Acorn have designed 
an allocation strategy that aims to reduce 
file fragmentation, and speed up access. 


This strategy only really applies to hard 
discs, which have more than one zone in 
the map. Directories are allocated from 
the middle zone outwards; hence the root 
structure will appear somewhere close to 
the middle of the disc. Whole files (not 
those created using OPENOUT) are 
placed in the nearest zone to their parent, 
working out in either direction. This 
achieves the very important goal of 
keeping files close to their parent 
directory. When these files are accessed, 
head movement, and hence access time, 
will be reduced, as the file is as close as 
possible to its parent. 

The situation with OPENOUT is more 
difficult, as random access files tend to 
change in length, and therefore require a 
different strategy. In this case, RISC OS 
searches the map zones making a trade off 
between how far out from the parent zone 
it must move and how much fHe space is 
in the zone. In other words, it trades fast 
access by being close to the parent against 
the possibility of having to fragment the 
file, caused by choosing a zone with not 
enough free space. 

All this is OK provided the required 
space can be found. If it can*t, RISC OS 
must decide whether to fragment the new 
file, or to move other files about to make a 
suitable gap. RISC OS contains a very 
efficient compaction routine that can 
quickly calculate how to move fragments, 
and then move them with the minimum 
fuss. When saving whole files, compaction 
continues until a large enough gap is 
formed, or the data moved about on the 
disc is over twice the length of the file 
being saved. In this latter case, the file is 
fragmented into adjacent gaps, to 
minimise head movement between one 
fragment and the next. Random access 
files are only compacted when opened or 
closed, and then only if a very good 
opportunity exists. The net effect of this is 
that whole files are hardly ever 
fragmented, and long-lived random access 
files which may start fragmented tend to 
recombine as time goes by, 

^ Fni ir r> 
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Disc 1 
Disc 4 
Disc 5 
Disc 6 
Disc 10 
Disc 19 
Disc 29 
Disc 30 
Disc 31 


Archimedes Software 

] Dl8C 7 - A Chess Program for The Archimedes. 

A Chess prograni that takes full advantage of RISC OS. installing itself on the icon 
bar and running on the desktop In a window at the same time as other 
applications. You can cany on working whilst the program is thinking of its move. 
"m Features: load and save games, edit board, step backwards and forwards through 
11 game, computer V computer mode, play black or white, reverse board, save 
f I game, multiple levels, print game. Algebraic r>otation. Full mouse control, on 
y screen clocks. Hint. Choice of piece when promoting pawn. Undo move. 


Disc 16 - A New Spark RISC OS Archive program 

Spark, allows you to store files and directories In archive files in a very 
compressed form. e.g. sprites often take up only 10% of normal space. Fites In 
y\ archives, can be accessed just like files in disc directories. Now new Spark series 
' 2.XX. has lots more features. Background operation - archive whilst you do 

_J something else. Reads ail these formats, zoo. zip, Izh, UNIX and Archie Tar, 

Compress. Reads and writes PKarc, SEA/PC arc, uucode, atob/CET+, FCET arKi 
Archimedes archives. New 16 bit higher performance compression. Script files, 
message driven operation. DES data encryption. Full info, sort by type etc. 


( Disc 22 - Novapalnt 16 colour paint package. 

Paint package with two tone font system, user defined brushes, airbrush, auto- 
shader, colour fills, define graduated palettes, pixel average, area squash/ 
stretch/distorVrotate. sphere wrap, cylinder wrap. Online help, manual, demos. 
New version uses full screen for editing, but allows file load/save from desktop. 

Disc 24 - RISC OS Desktop Multitasking Terminals 

Bring Archie com ms to the desktop. Stay online whilst using other programs. 

^ Good quality high speed. Viewdata and ANSI/VT220/100/52 emulations. Suit 
[j Prestel. bulletin boards and mini/mainframes. Auto logon scripts. CET, ASCII and 
X/Ymodem (batch), file transfer. RISC OS printer driver support. (RS423state. 

^ Discs 12 and 26 - The World and World Map 

u Database of 130,000 coordinates of points on Earth and IWorldMap to convert the 
M data into IDraw file maps which can be imported Into Draw, Ovation etc. 

X {Discs 12 and 26 tx>ught together cost £6.99 and then count as one disc). 


EMACS. Classic multi document editor with macro language. Includes full C source. 

\ XLISP. Object oriented version of USP complete with C source code. 

» C Toolkit. 20+progs for C programmers with sources, grep, awk, make, sed, more... 

I Kermit. Archimedes, BBC and MSDOS versions of file transfer/communication, prog, 
i More C Tools, yacc and lex with examples and C source. New versions... 

I Starchart RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 

► iPcompile. Desktop wimp based front end for ISO Pascal compiler. 

I XLIB. Library of extensions for Pascal. Interface to wimps etc. Lots of Pascal progs. 
PipeDream Extras. 250,000 word US English dictionary. Printer buffer, and autosave 
(automatically saves documents every so often). Needs hard disc for dictionary. 


Each disc is £5.99 inclusive. Buy four claim another one free! 

David Pilling, P.O. Box 22, Thornton Cleveieys, Blackpool. FY51LR. 

Free Air Mail delivery on overseas orders. Full list available on request. 

















This month we get right down to basics with a topic about which we 
receive many queries, and that is the use of iSystem. This dearly 
causes a lot of confusion for many users. Mike Wiiiiams deals with this 
topic using a question and answer approach. 

I often see references to ISysfem. What If you have a system with a hard disc, 
is thief ISystem ia normally stored in the root (top 

most) directory of the hard disc. Opening 
ISystem, also referred to as Sys^em this directory, or configuring your machine 
EesourceSy is provided as an essential part to boot the hard disc when the system is 
of RISC OS for the Archimedes, and is to be first switched on, will ensure that ISystem 

found on Applications disc 1, Its function is is always seen by RISC OS. Subsequently, 
to provide a number of resources which are any request for System Resources can be 

needed (shared by) many Applications. met straight away because RISC OS 
These resources are usually in the form of knows where it is located, and it is 
modules kept in a separate Modules immediately accessible, 
dlr.ctoiy within the ISyBtem application 


If $0 many programs need these I 
resourceSf why are they not I 
included with the rest of RISC OS I 
so that they are available as soon I 
as the machine is switched onf P 

This would be ideal, but would m 
cause problems if and when any of the 
resources are updated (as has already 
happened with CLib and FPEmulator). 

It would also prevent other system 
resources (which are supplied with specific 
applications) from being incorporated into 
the same system. 

OK, so what do I do with ISystem? 

[System is supplied on Applications 
disc 1. When you first switch on your 
machine, insert this disc and open its 
directory viewer to show the ISystem icon. 
Once this has been done RISC OS has 
*seen’ System Resources, so should any 
subsequent application require any of the 
modules it contains you will be asked to 
re-insert Applications disc 1 for the 
relevant modules to be loaded. 


Typical contents of ISystem and the modules 
directory 

Of course, if you press CtrhBreak at 
any time you effectively reset your 
machine, so its knowledge of ISystem will 
also be lost (unless Ctrl-Break reboots a 
hard dise as described above). 

In addition, if you want to ensure that 
RISC OS uses a particular copy of 
ISystem, then open the relevant directory 
viewer for this version and double-click on 
the ISystem icon. Note that, by default, 
this action in itself will not load any 
modules from [System. Properly written 
applications will always check whether a 
module is already in memory before 
attempting to load a module from 
ISystem. 
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Thai all sounds fairly straightforward 
However^ I sometimes see the message 
^System Resources not found”. Why is 
that? 

This will usually only happen if you try 
to run an application which needs to use 
one of the ISystem modules, but RISC OS 
has not seen the directory viewer 
containing ISystem, so it doesn’t know 
where to find it. Tb overcome this possible 
problem, some applications come with 
their own copy of ISystem on the same 
disc, so once you open the directory viewer 
for the application, RISC OS will also 
have seen ISystem as well. 



Finding module names and version numbers 


Does it matter then if I have more than 
one copy of ISystem on different discs? 

In an ideal world, only one copy of 
ISystem would ever be needed, and hard 
disc users in particular would have no 
further problems. The question to ask is 
really not ‘Does it matter?’ but ‘Why do 
some applications have their own copy of 
ISystem if one is supplied with every 
Archimedes?* There are two answers to 
this, and it is here that the concept of 
shared resources starts to come a little 
unstuck. 

Some applications require an updated 
version of one or more modules. Although 
Acorn will normally ensure that the copy 
of ISystem supplied with each Archimedes 
is updated when a new version of any 
module is released, no software house can 


rely on every purchaser having the latest 
version of each module. Thus a copy of 
ISystem with the latest version is often 
supplied with the application. 

In addition, some applications require 
modules which are not supplied as 
standard with each Archimedes. One 
example is ABC Lib which is required by 
Basic programs compiled with the ABC 
compiler from Dabs Press. This was 
required by Genesis from Software 
Solutions which used ABC to compile its 
Basic version of Genesis. 

The problem that arises with this 
approach is that any ISystem supplied 
with another application may well contain 
only the modules needed by that 
application. Suppose you have used 
Genesis as above, and then try to run 
some other application. You may well 
encounter an error message because the 
second application needs to refer to 
ISystem, but as far as RISC OS is 
concerned the copy it has seen (and hence 
the one for which it asks you to load the 
disc) is the one supplied with the first 
application. This ISystem may not contain 
the modules (or versions) needed by the 
second application. 

Another example of what can happen, 
is that the version of ISystem which RISC 
OS has seen may not contain the latest 
version of a module needed by the 
application you are trying to run, and you 
will get a message along the lines of “CLib 
version 3.5 or later needed”. You may have 
that version, but if it’s not in the copy of 
ISystem that RISC OS has seen, then 
RISC OS can’t find it. 

This now sounds very confusing. 
Apparently I may have different 
versions of ISystem on different discs, 
hut RISC OS doesnH know which one 
to use most of the time. Is there any 
way of making life simple again? 

There are two things that will help you 
and your Archimedes to run more 
smoothly. First of all, try to keep the 
number of copies of ISystem to a 
minimum. If you have a hard disc, then 
you are fortunate, and you should keep 
one single copy of ISystem in the hard 
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disc's root directory (with a backup on a 
floppy) - but see tbe second point. 

The other and most crucial thing you 
can do is to ensure that all the copies of 
[System which you have are identical, that 
is that they contain the same (and latest) 
versions of the same set of modules. To do 
this, I suggest you keep one master copy of 
[System (it could be the one on Apps 1) 
and a list of those discs which contain 
another copy. Whenever a module is 
updated to a later version or a new 
module added to your master copy of 
[System, you should then replace all your 
copies with a new copy of the master, one 
reason for keeping the number of copies to 
a minimum. 

This may seem a bit of a chore, but you 
won't need to do anything very often, and 
it will ensure that whichever copy of 
[System RISC OS sees first, it will always 
contain all the modules, and tbe latest 
versions, which any other application 
might need. Acom has now come up with 
a utility called Sysmerge to help in 
updating [System, and this is increasingly 
likely to be included along with [System 
on applications discs by software houses 
(see Magpie review in this issue). Don’t be 
surprised if you get asked to re-insert a 
disc you last used half an hour or more 
ago - it could be that it had a copy of 
[System which RISC OS needs again. 

Well that doesn^ sound too bad after 
allf but how do J know which is the 
version number of any modulef 

This is a little more complicated, 
though if a copy of [System is supplied on 
a disc with other applications, the 
documentation supplied with the disc, or 
help files on the disc, may give you this 
information. Otherwise switch on your 
Archimedes and proceed as follows. 

Insert a disc containing [System in a 
drive, and open its directory viewer by 
clicking on the disc drive icon on the icon 
ban Now open tbe application directory 
for [System by double-clicking on the 
[System icon while holding down the Shift 
key. You will see IBoot, [Run and [Sprites 
files and another directory called Modules. 
Double-click on this to open it in turn. 
This will show the various modules 


supplied with this copy of [System (the 
icon for a module has the letters KM top 
left, and the Archimedes 'A* bottom right). 

For each module in turn, double-click 
on its icon to load it into memory and then 
press FI 2 giving the prompt at the foot 
of the screen. TVpe: 

Modules 

for a list of current modules. The one you 
have just loaded will be tbe last in the list 
(you may need to press Shift to scroll the 
display). Note that the name of the loaded 
module may well be different from its 
name in the directory viewer - for 
example, CLib appears as Shared 
CLibrary. Once you have identified the 
name of the new module, type in: 

Help <module naine> 
as, for example: 

Help SharedCLibrary 
This will tell you the version number. 

It may be as well to keep a list of the 
version numbers so that you can check 
any newly acquired copy of [System 
against your current master version. 


Moduio 

Loaded 

Latest 


Name 

Version 

CUb 

SKaredCUbrary 

3.66 

FPEmyiator 

FPEmulaior 

2.80 

Colours 

CoiourTrans 

D.60 

ABCUb 

ABCLbrary 

2.40 

MsgTrans 

MessageTrans 

0.06 

WimpUtils 

WtndowUtils 

0.04 


Table f. Latest System Resources 


If you follow the advice I have given 
here regarding [System, and keep all your 
discs well organised, you should ftnd few 
problems with [System, and at least you 
are now prepared for why anything might 
go wrong. For reference. Table 1 gives a 
list of the [System resour<»s of which we 
are aware and the latest version number 
of each. However, do not worry if you do 
not have the latest version of each module, 
or even all the modules listed. As 1 said 
before, any application needing a later 
version of a module or a non-^standard 
module will normally include an 
appropriate copy of [System on the same 
disc (we do this with RISC User magazine 
discs where necessary). 
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CAD AND CAD / CAM SOFTWARE FOR THE ARCHIMEDES / A3000 



DESIGNER 

(ARCHIUEDES) 


CNCDESIGNER 

(ARCHIMEDES) 


DESIGNER li™5 is A powerfLi, yel easy to use 2D dratjgliting 
system, based on its big bfiothef DESIGNER (ARCHIMEDESJ. 

It is Kteal tortt>eprodiictk)n ot Ngti quality, aEcurate draMngs, 
paitioularty wher Wrked to a. plotter. It maK® light woritof ail the 
difficult areas ^ CAD, such as true btefidmg arcs and (argents, 
ample deiehon ef part lines ard aits, autoinatic haldiiog, etc. 
Fufttw feature Include ellipses, diineroionjng. tejct move, 
rotate mirror image, alter size, paa zmm etc. DESIGNER 
iNTRO is an ideal imroduction to CAD, Intact it will easily cope 
with all of mo^ peoples draughting requirernems. 


DES^NER iARCMIMEDES) offeria range Ottovnas thai go 
welt beyond iiiai draughtiTiQ. As weN as a wide range ef 
diaughtbrig ophrxis it also provides some (Tf the most 
comprehensive teid (iridudir^ font/symbol dfisign), drawing 
manipulation andedttir^ capabilities aveitable. Addibonaliy. a 
3D option allows '30' extrusions in a variety of 
projections, arid wireframesolids of rewliition. to be created for 
QUi^ and simple visuaiisatkin The i^aphicdesgn capability of 
DESIGNER(ARCHIMEDE5| easily encorripaese^ 
8ctivHiesaaengineeenngf9fichitEchjral drawing, poster design, 
logo or sign desi^. dress designi, cartogr^ihy, etc. As well as 
supporting a vast range of plotters, DESIGNER (ARCHIMEDES} 
alsohasapecrhcoLT^utstof such devices as the RCXAND 4 
CAMM1 vinyt cutter and the CAMM Sengraver^llef (both 
available from TechSofft}. 


CNC DESIGNER (ARCHIMEDES! provides a me^ to realise 
the true potential of CNC lathes in eckicatioa It» an integr^^ 
CAD/CAM system oonpissd of thefuH DESIGNER 
(ARCHi MEDES] system plus a fully automatic post procesaorfor 
CNC lathes, Sknpiy drawn half profUeof a oomponem ustogthe 
cad routines, and a full CasiC part program isautomabcaliy 
generated Once generated die part program is transleriried to 
the lathe’s own software for manulactere. Simpie or comptox 
components, including part arcs, screwthreads, boring, owen 
ellipses can be easily designed and realised by students of all 
ages, in many ca^ transfer to B8C/Master software is 
possible. Aval labte tor a rangeof Boxtord, Conect Denfond. and 
Emcolaihee 


OTHER PtiODUCTS FROMTlCHSOn'MCL^ 

CAD and CAD / CAM ^iftwsrefcr the BBC B / Master senes 

CAD relatedoomputerperlpherals 

Ptctters + accessories 

Digitisers 

Cutter platters 

Engraving riiachlne 


All orders rmrtted "Sale or Return" will be supplied with an evalu- detail. Besidra, 1 

^on disc in additoite the main disc. If the software is returned in feature -the sim 

goodcondrtton.witotlterriain disc still s^ied, within 2&dsys, a full curve and raprd' 

refund will be given. ■ ORDERING 

{Anyone in education is welcome tohaveaneveluation copy to Cheque with ore 

reviewfor 28 days, free of charge.} Add VAT at 15% 1 

Full InlormfftiQn i* In CKir Product Guide available on negugaL 


TeenSoft UK Ltd 
Old School Lane. Erryrya. MOLD. 
Clwyd CH74DA 
Te^:(0a243>3ie Fax: (08^43) 5E4. 






Mastering the Wimp 

Part 16: Redraw Revisited 


by Lee Calcraft 

I n part 5 of this series we looked at the 
way in which a task should respond to 
the Wimp Poll reason code with value 1 
(Redraw_Wiiidow_Request)- To keep 
things simple^ we made our test task 
respond to redraw requests by redrawing 
its whole window each time around. This 
is ok in a test program, but if your work 
area contains anything more than a trivial 
amount of text, you will slow down the 
Desktop to an unacceptable degree. This 
month we will take a closer look at the re¬ 
drawing process with a view to keeping it 
fast and efficient. To see how fast an 
application can respond to redraw 
requests, load a large text file into Edit, 
and then move a small window across it. 
You will see that redrawing is handled 
quite efficiently, and the progress of the 
window which you are dragging is not 
noticeably slowed - unless the text in Edit 
contains very long lines {or worst of all, no 
carriage returns at all). In this case, 
redraw is impossibly alow. 

It takes more than a little thought to 
ensure that your Wimp task contains fast 
and effective redraw routines. The 
simplest way to achieve great speed is to 
let the Wimp do all the work, and put all 
your text into icons. This sort of approach 
is only suitable for very specific 
applications however. It is impractical for 
large quantities of text, or text that is to 
be manipulated to any degree. In such 
cases you will have to resort to writing 
your own fast redraw routine. 

REDRAWING TEXT 

The principle involved in creating fast 
text redraw routines is simple: redraw 
only that part of the window which the 
Wimp nominates. In practice you can get 
away with redrawing complete lines of 
text (of up to 40 or even 80 characters in 
length), providing you only redraw those 
lines which fall within the nominated 
area. This makes life a bit easier, since we 


only need to worry about the y co¬ 
ordinates of the redraw rectangle. 

Exactly what form the code in your 
redraw loop will take depends on how you 
have stored the text which is to appear in 
your window. Perhaps the simplest 
approach is to store it in some form of 
array. For example, a simple string airay 
in which eadi line of the displa 3 " is held in 
a separate element. This is easy to handle, 
and we will look at this case first, but 
before doing so I will mention a more 
flexible alternative. 

If you have a sizeable quantity of text 
in your work area, and especially if you 
are to manipulate it in any way, then long 
string arrays are out, since they provide 
no flexibility at all. The only viable 
alternative is to store the text directly in 
memory, perhaps using character 13 as an 
end of line marker, or perhaps without 
any such markers. In either case, you 
must hold an array of pointers to the start 
of each line. This is essential, because 
there is no time to work through the 
whole file to discover where each line 
begins once a redraw request has been 
received. The redraw process is extremely 
time critical, and if it is slowed down in 
any way the Desktop will become very 
sluggish indeed. 

By holding an array of pointers, you 
can immediately find the start of the line 
of text to be displayed, given the number 
of the line, counting from the start of the 
text file. We will give an example of this 
technique in due course, but we will start 
with the slightly simpler case of text held 
in a string array. 

REDRAWING TEXT HELD IN 
AN ARRAY 

The best way to see how this is 
achieved is to look at an example. The 
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procedurf- PROCredraw in listing 1 
implements a fast redrawing routine, and 
one whose speed is independent of the 
amount of text held. If you want to try it 
out, you can call it by placing the following 
line in the Wimp Poll 
loop of an application 
program: 

WHEN l:PEDCredraw 
The procedure is 
quite self contained, 
and aseumes that the 
text to be redrawn is 
held in the array 
display$Ot and that 
there are currently 
di8psize% valid lines. 

If you want to test 
the procedure out in a 
controlled way, you 
could use it with the 
very short Wimp 
program developed 
last month to illustrate the use of 
templates. In this case, you will need to 
use the Template editor to alter the main 
window as follows: 

1. Unset the auto-redraw flag 

2* Remove any icons from the window 

3* Extend the vertical work area extent 
to at least 2000 OS units 
Finally you will need to include 
PROCmakearray from listing 1. This 
simply sets up a suitable text array. This 
procedure should be called once at the 
start of the program. 

HOW IT WORKS 

PROCredraw is really a pretty 
straightforward redraw loop, designed to 
display the block of text indented by 16 OS 
units from the left hand side of the window* 
First of all we obtain the co-ordinates (in 
OS units) of the the work area origin by 
subtracting the position of the x and y 
scroll bars from the co-ordinates of the top 
left-hand comer of the visible area* All this 
information is returned by the call to SYS 
“Wimp_Redr aw Window^. Table 1 gives the 
parameters, but see also the PKM page 
1204 for further details* 


As you can see from the program there 
are two nested WHILE loops. The outer 
one cycles round once for each rectangle 
which the Wimp requests to be redrawn, 
while the inner one prints just those lines 
which feature in 
the nominated 
rectangle. This is 
achieved by 

obtaining values for 
top% and base%. 
These are the 
upper and lower 
bounds of the 
region that the 
Wimp has 

requested to be 
redrawn, and are 
measured in OS 
units relative to the 
work area origin* 
To determine which 
lines of the array to 
print we just divide 
these values by 32 {since each line of text 
is 32 OS units in height regardless of 
which mode is used in the Desktop). At 
the bottom end (base%) we add a small 
measure to counteract the effect of 
rounding down (since integer division is 
used), and there you have it* 

The case where the text to be written 
is held in a block of memory is very 
similar. Suppose that the array array%() 
contained a set of pointers to the start of 
each line of text in such a way that 
array%(0) contained the address of the 
start of the first line of text, and so on. AJl 
we would need to do to alter PROCredraw 
appropriately is to replace the PRINT 
statement by: 

PRINT $arrayHi%) 

This assumes that each line of text is 
terminated by a carriage return character 
in memory* 

Incidentally, to see just how slowly the 
redraw routine operates when the whole 
text file is redrawn in response to every 
redraw request, alter the assignments of 
top% and base% in the outer WHILE loop 


On entry 

Rl-pointer to block 

On exit 

R0*0 for no more rectangfes to 
redraw 

R1+0 

window handle 

R1+4 

visible area minx coord 

R1+8 

visible area min y coord 

R1+12 

visible area max x coord 

RU16 

visible area max y coord 

R1+20 

scroll X offset rel to wae origin 

R1+24 

scroll y offset rel to wae origin 

R1+a8 

curr graphics window min x coord 

RU32 

curr graphics window min y coord 

R1+36 

curr graphics wirxlow max x coord 

R1+40 

curr graphics window max y coord 


Tab/e 1. Param&t&r block returned with 
SYS **Wimp_FedrawWfndow" and SYS 
■ ■ Wfmp_ Getftectar^gte ”. 
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topl=l 

base%=dispsize% 

If you now re-ruu the program you will see 
that any attempt to drag an object across 
the task^s window is impossibly slow - and 
this is only with a very short text file. 



You can test the spee<t of redraw by tlragging a 
small w/ndowacross the window c/your task. 


REDRAWING GRAPHICS 

When redrawing graphics objects, two 
different approaches can be adopted. 
Either you can use a technique similar to 
that discussed above for use with text, 
where you determine the co-ordinates of 
the area to he redrawn, and redraw just 
that area; or you can take a short-cut and 
use sprites. In practice, the first of these 
two methods may not be feasible in all 
situations. It may not be possible to draw 
the right hand part of a graphic without 
having drawn the left part first - or at 
least without having calculated where 
the left hand part would fall. Also there 
may be no easy way to know exactly 
which part of your drawing code to 
activate to draw a particular segment of 
a drawing. 

For example, suppose the graphic is a 
map of the U.K., and that it is drawn from 
an array of points. There is no obvious 
way to get from the bounding rectangle 
returned by the Wimp with a redraw 


request to co-ordinates of the points 
required to redraw the nominated area. In 
such cases, the fastest redraw will often 
be obtained by initially drawing the 
graphic to a sprite, and then redrawing 
this in full when redraw requests are 
made. Of course large sprites can take up 
a great deal of memory, but this method 
can be very effective. If you are interested 
in pursuing it you are referred to the 
Desktop Graph Plotter described in RISC 
User Volume 4 Issue 1 page 15, where this 
technique is used to good effect. 

Next month we will be finishing off the 
series with a look at the way in which 
applications can interface with the RISC 
OS printer drivers. 

1000 DEFPROCredraw 

1010 SYS "Wijnp_RsdrawWindovf",/blocks TO 
more% 

1020 x01=l6+blockt!4-block%120 
1030 yOl—16+blockl!l6“blockl!24 
1040 WHILE morel 

1050 topl-(y0l-blacklt40) DIV 32 
1060 IF tOpKO THEN topl-O 
1070 basel»(47+y0l-block%!32) DIV 32 
1080 i%®topl 

1080 WHILE i%<dispsizel AND i|<“base% 
1100 HOVE x0l,y0%-(il«5) 

1110 PRINT display$(il) 

1120 il+-l 

1130 ENDWHILE 

1140 SYS "Kiinp_Get Rect ang le",, blocki 
TO morel 
1150 ENDWHILE 
1160 ENDPROC 
1170 : 

1180 DEFPROCmakearray 

1190 Dm display${200) :BI-1 

1200 A^=STRIKG$(8,’’RISC User ") 

1210 FOR Al-0 TO 200 

1220 di3play${A|)-MID${A$,E|,60) 

1230 B|-B% MOD 10 +1 

1240 NEXT 

1250 dispsizel-Ai+1 

1260 ENDPROC OT 
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Pirate Software 


The ultimate rally 
driving simulator 
for the Archi¬ 
medes, incorpor- 
ating 4 billion 
fractal generated 
landscapes. 3D 
solid polygon 


graphics, samp¬ 
led speech ter 
course notes - 
you will even be 
able to win prl 2 e 8 
by entering the 
regular prize ral- 
iiesl 


Proudly Presents 

Fast ‘n’ Loose 

Only £17.50 including VAT and Post. 

For free playable demo, version, send a blank disk and a SAE. 

Avalabte only by mall ofOer ttom Pirate Softwaia. P,0. Box Bi26. HuddarBfWtt, Weal Yorkshire. HDI TYH, 


"F I R S T" 

ADVANOED STATISTIOAI. SYSTEM 

For Acorn Archlmodos; BBC Models B, B* and Mostor; 'Induifry Standard* moctilnes 
A powerful and practical tool for Research, Industry, Business, and Teaching 

Integrated, interactive, robust, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data tran&fdcms. 
Handles missing values arte data stijseis. Scatlerplots, regression plots, function plate. 
Univariate stattetics. Paired and unpaired t tests, Chisquare tests, Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardise. Full statistical intermation. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, Influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- TWO’ and Thfee^way ANOVA subsystems. Distributions generator. Hfetograms. Linear Calibration, 
Cluster analysis. Many other powerful anatylical and descriptive feabjres. Fill utilities. 

Price £120-t180 (machine and version dependent). Special RISC USER discount available. 
There's far too much to desalbe here, Get full information now from: 

Serious Statlsttcd Software, Lynwood, Benty Heath Lane, WSIoslon, South Wlifcd L641SD Tel. 0S1327 4260 









Oa m « t 


11 r1 OHS 

AJerion 

£1255 

1st Word FJi»n 

All in Boxing 

02.95 

8 bit Sampler 6c K£di 

Apocalypse 

£2655 

8 bit Sound Sampler 

Arcade Soccer 

£17.95 

Acorn DTP 

Battletanks 

£12.95 

Alpha Base 

Bug Huntef 

06.95 

Ancestry 

Caverns 

£1655 

AnsiCKeteaBeS 

Chocks Away 

£2255 

Arc Comm 

Corvqueror 

£2255 

AicPCB 

Cops 

0755 

Arc PCB Professional 

Corruption 

£26.95 

Ancl^FS 

Drop Ship 

0755 

Arcfiftnedes 3.5" Mve 

E-Type 

£17.95 

Arc Assembly Lang 

Fird^m 

£17.95 

Arc Basic Compiler 

Fish 

£2655 

Aidight 

Guild of Thieves 

£26,95 

Aimadeus (software) 

Herewith ttie dues 

£22.95 

Aimadeus {hardware 

Holed Out 

07.95 

Artisan 2 

Holed Out Designer 

£17.95 

Assembler 

Hostages 

0755 

Atelier 

Hoverbod 

£12.95 

Autosketeh Version 2 

Ibix the Viking 

£1755 

Cambridge Pascal 

Inerda 

0755 

Datavision 

Interdktor H 

£3055 

Ddtabase 

Jet Fighter 

£12*95 

Efosktop Office 

Mad Professor Mariartt 

07.95 

Disc Tree Version 2 

Maddingly Halt 

£12.95 

Baslword 

Man at Arms 

07.95 

Euclid 

Manchester United 

0155 

F0m Maker 

hfinotaur 

£12.95 

Financial Accountant 

hfissite Control 

£12.95 

Flejdfile 

Nevryon 

0755 

Fortran 77 release 2 

Orion 

£12.95 

Gamma Plot 

Overload 

£12.95 

Genesis 

Fipemania 

01.95 

Gerber Plot 

Pon! 

£15.95 

GraphBox Version 2 

Pysanld 

£17.95 

Hearsay 

RealMcCdy 

£26.95 

Home Accounts 

Recfehift 

05,95 

HotUnJe Presenter 

Repton 3 

£17.95 

Impression 11 

Rotor 

01.95 

Impression Junior 

Sporting Triangles 

0155 

Instigator 

Superior Golf 

£17.95 

Iso Pascal Release 2 

Taitsman 

£13,95 

Knowledge Organiser 

The Olympics 

£17.95 

Lisp 

The Pawn 

£26.95 

Lo^tix 

The Wimp Game 

0755 

Mailshot 

Thundmnonk 

£1195 

Mogul 

Trivial Pursuit 

06.95 

Multistore VH 

UJ.M. 

0655 

Newhall Font Pack 

White Magic H 

£17.95 

Nomina] Ledger 

World Cl Leader Board 

0655 

Ovation 

Zarch 

07.95 

PC Access 


BESrSOFTWfIRE 
BEST PRICES 


£79J5 

£179.95 

£12455 

039.95 

£44.95 

£6955 

£144.95 

£29.95 

£174.95 

£31955 

£26.95 

£89.95 

£19.95 

£89.95 

£4455 

£6955 

039.9S 

£4955 

£19955 

£3955 

£79.95 

£69.95 

£12955 

£25.95 

£10955 

£4455 

£34.95 

£5955 

£84.95 

£22955 

£129.95 

£9455 

£59.95 

£84.95 

£10455 

£69.95 

£59.95 

£44.95 

£49.95 

06455 

£8955 

£44.95 

£99*95 

£49.95 

£19955 

£99.95 

£36.95 

£17.95 

£24995 

£4455 

£57.95 

£99.95 

£34.95 


PC Emulator 

£9955 

Pjpalream 3 

04455 

Ptesentation Systen 

£69.95 

Presenter Q 

£39,95 

Pfo Artisan 

£84.95 

Prolog 

099,95 

Purchase Ledg^ 

£57.93 

KeaJHme Solids Modler 

£164.95 

Render Bender 

£7095 

Reporter 

£3455 

Rhapsody 

£44,95 

Rise Basic Compiler 

£129.95 

Rise Forth 

£129.95 

Progs. Ref. Manual 

£79.95 

Robo Logo 

£36.95 

Sales Ledger 

£57.95 

Scan Light Junior Arc 

£19955 

Scan Light Junior A3000 

£199*95 

Scan ]%ht Senior 

£42955 

Schona 

00955 

School Adnvinistrator 

m95 

Sigma Sheet 

£5955 

Software Dev. Toolbox 

£199.95 

SolidCad 

£129.95 

SolicbRender 

£129.95 

Solidtools 

£319.95 

Spellmaster 

09.95 

Stock Management 

£57.95 

Syetan Delta Plus 

£6995 

Tempest DTP 

£109.95 

Tracker 

£4455 


Our software price list ofiers all the 
latest ArcNmedes software at a 
dscount of around 10% or more. All 
listed prices Include VAT and PfiP, 
Goods are normally despatched first 
class within 46 hours, - subject lo 
avaJiahfifty- 

flRCimiH4 SOFTmRE SCIPPUES, 

poBmmr. 

Sntlofl Coldllcld. 
B7430L 

Public Dofflain&flTai'e 

We are stl able to offer the best 
Archimedes PD setection. with a 
fast efficient s^vlqe for ortly £1*B0 
per dtec. Send a £1 cher^ue or coin 
for Arcaynia Demo/Cataioj^ie Disc 
4 * Or send a SAE for a fun list Of all 
our Commercial and PD software. 



WP/DTP _ 

Using fhe IBM Character Set with 1st Word Plus 

by Mike Hunter 



Implementins this ftxcility requires a data 
file which is supplied only on this montk^s 
magazine disc. 


(UK) alphabet, but overwrites characters 
&A0*&FE with some characters from the 
standard IBM alphabet, using 
VDU23,n,dl»dS sequences stored on disc 
as a file called Alpha_IBM. Characters 
&S0-&9F are not displayed by IstChars, 
and in any case some of these are needed 
by RISC OS for window icons, so the IBM 
characters normally coded in this range 
instead replace some of the less useful 
graphic characters at &B0-&CF. 
Characters &A0-&AF and &E0-&PE are 
standard IBM printer characters, while 
&D0-&DF provide some of the printable 
IBM graphics characters. 


Ist Word Plus uses the application 
IstChars for the entry of non-keyboard 
characters into the text This displays the 
‘printable^ characters of the current 
alphabet in a window* Clicking with the 
mouse on a character in this window 
enters that character into the text at the 
current caret position. Any alphabet may 
be selected, and will be displayed in the 
IstChars window. 


Unfortunately, the printer drivers 
supplied with let Word Plus do not 
match the characters in any of the 
RISC OS alphabets. Thus, even with 
the default (UK) alphabet, there are 
characters which can be inserted into a 
1st Word Plus document on the screen, 
but which will not print on paper. 

In principle, some printers which 
accept downloaded character 
definitions could be made to print all 
the * printable’ characters correctly. 
However, some printers have very 
limited download capabilities (e,g. 
Epson LX), or downloading requires 
setting a DIP-switch or sacriBcing the 
print buffer Ce,g. Epson LQ). In any 
case, Acorn does not provide 
downloadable fonts, even for its 
default alphabet. 


i ch.ar^cte'rs like j acid c at bi 

11 nausf p-Diatir ini iit Ut 


sfEniw by usim 

riif Eirrispi^ntlsng 1st Hard ?liii printir has iiit \im laadel 
J4it(watiaall!f ly tht lEHahjrs aFPlitadinEi. 


1st Word Plus wltti window showing IBM-tIke 
character set 

To print the alphabet defined by 
IBMchars, a suitable printer driver must 
be installed in 1st Word Plus. Many Epson 
This article explains how you can use a (and compatible) printers will print the 

new application IBMchars to define an IBM character set while remaining in 

alphabet, with some useful characters Epson mode, on a software command, 
(e.g. Greek and other characters without requiring DlP-switches to he 
commonly used in scientific writing) not changed. The printer driver 1 use does this 
present in the default Archimedes for my LQ-compatible Star LC24-10. 
alphabet, all of which may be printed on a However, very few alterations should be 
printer which has the standard IBM needed for other Epson/oompatible printers, 
character set (true of many printers on the or for printers in IBM emulation mode. 


market). 


IMPLEMENTING IBMchars 


The IBMchars alphabet uses characters To use IBMchars you will need to 
&20-&7E from the Archimedes default create a modified version of the Ist Word 
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Fills IstChars application and save it with 
this new name^ Both lstWord+ and 
IstChars are supplied by Acorn on the 1st 
Word Plus Program Disc, and it is a good 
idea to install IBMchars on the same disc^ 
or even better on a backup of the original 
which you use as your working copy. 

First of all you will need a new 
application directory to be called 
[IBMchars. Such a directory is supplied on 
this month^s magazine disc ready for use. 

The file Alpha_IBM (supplied on the 
magazine disc) in IBMchars contains the 
definitions for the IBM character set. This 
application also contains an alternative 
sprite to be used as the application's icon - 
you could design your own if you wish. 

You will also need to copy the 
IRunlmage and Templates files from 
within IstChars to the new application 
IBMchars. In addition you will need to 
incorporate a I Run file in your new 
application. Read the IRun file from 
IstChars into Edit^ add the following two 
lines following the initial comment line, 
and then save this version as IRun in the 
lIBMchars directory: 


P rint <Obey5 Dir>, Alpha_IBM 
Copy adf s:: 1WP_P rog, $.! 1 s tWordl+, <new_driver > 
adf s:: lWF_Prog. S, I l3tWord+, Iwp^print F^C 

Note that <new_driver> is the modified 
printer driver for IBM characters (see 
below). 

To be able to revert to the normal 
character set (using IstChars) it is helpful 
to modify similarly the IRun file in the 
!IstChars directory to include: 


Copy adfs::IWP Prog.$,!lstWord+.<normal_driver> 
adf s::lWP_Prog.$.!1s tWord+,Iwpjprin t F 


where <normal_driver> is your normal 
printer driver. 


driver for use with your own printer which 
will select the IBM character set. The 
magazine disc contains source and 
assembled printer drivers for the Star 
LCIO and LC24 printers (in directories 
Source and Config within IBMchars). 

The sources supplied may be used for 
guidance if you need to create your own 
printer driver. The principal requirement 
is to specify the translation table between 
the character codes used by the Arc and 
those used by the standard IBM character 
set. Use the 1st Word Plus utility 
IstConvrt to convert the source for any 
printer driver of your own into the printer 
driver itself. 

Assembled printer drivers should be 
saved in the !lstWord+ directory. This 
applies if you use either of the printer 
drivers from the magazine disc. 

Once IBMchars has been set up in this 
way, double-clicking on the IBMchars 
application will open a window showing 
the modified (IBM) character set (see 
illustration) and select the modified 
printer driver, while double-clicking on 
the IstChars application icon will restore 
(or select) the standard character set and 
the default printer driver. 

PROBLEMS 

Problems - character &A0 is assumed 
by 1st Word Plus to be a hard (non-break 
or fixed) space, and is shown as such in 
the IstChars character set window, 
regardless of how it is actually defined. 
IBMchars codes &A0 as a (a acute). The 
character &;FF is shown as y (y umlaut) in 
the IstChars standard alphabet, hut 
cannot be inserted into a document 
(IBMchars treats &FF as non- 
printable). The IstChars character set 
is displayed in a non-standard order 
intended to make its layout more 
logical. With the IBMchars alphabet, the 
result is less satisfactory. 


1st Word Plus also provides the source 
for creating your own printer drivers. You 
may need to create a modified printer 


Next month we hope to return to the topic 
of letter writing using DTP with *wore 
advice on letterheads. 
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Archimedes Memory Upgrades 


4Mb of RAM for your 

A310 or A305 is now only 
£399 inc. VAT/fitting 

This includes a free MEMCIa worth 
nearly £80, while stocks last. 

* ARMS compatible. 

* MEMCIa upgrade supplied. 

* Fully compatible with upgrades 
such as hard discs and 
backplanes. 

■k Price includes fitting and carriage 
both ways. 


A3000 RAM 

2Mb (total), £69i Upgradable to 4Mb. 

4Mb (total), £220. 

Bare board, £29, 

A data sheet is available for these upgrades. 
This explains the type of chips needed for 
the "bare board", which has high quality 
sockets for the RAM chips. Only 8 devices 
are required. 


400/1 series RAM 

IMb, £58. 2Mb, £100. 3Mb, £130 

Impression 2 

This is still only £145 inc. VAT when bought 
at the same time as any memory upgrade. 

Combination deals 

We can suppy and fit ARM3 upgrades as well 
as a range of hard discs. Call us to discuss 
your requirements. 


Why is it so inexpensive? 

Quite simply, by design. By using as few 
components as possible, the size of the 
board is reduced and production costs are 
lower. We implement 4Mb using just 11 
chips, whereas some other expansions 
need over 501 The use of fewer 
components results in lower power 
consumption, and greater reliability. 

8Mb potential! 

The small size of the board even allows an 
8Mb upgrade to be fitted - the A3S0? This 
would be impossible with other RAM 
expansions. Our information pack gives 
further details. 

For £399 inc. VAT you get; 

★ Courier collection of your machine. 

The improved memory controller, 
MEMCIa. This upgrade alone has an 
RRP of £79.35, and boosts the speed of 
the machine by approximately 10%. 

★ Fitting and testing of the 4Mb memory 
upgrade. 

★ Courier return of your computer. 

★ 12 month's warranty. 

Fitting time 

We use an overnight courier service both 
ways, and can therefore offer a turnaround 
of typically 2 or 3 days. 

Further details 

An information pack is available which 
gives further details on this upgrade. 

Write or phone for a free copy. 

Ordering details. Ail prices include VAT. 

by Access. Visa or cheque with order. 
Official and overseas orders welcome. 


^ IFEL, 36 Upland Drive, Derriford, Plymouth, PL6 6BD, (0752) 847286 



Bicubic Parametric What? - 

A first look at Bezier Curves (Part 2) 

Derek Marriott concludes his discussion of Bezier curves by looking at 
their application to three-dimensional objects. 


THE THIRD DIMENSION 

One of the most popular methods for 
describing a surface in computer graphics 
is the Bezier Patch, developed in the 1960s 
by Pierre Bezier for use in the design of 
car body panels for Renault. Hie computer 
aided design (CAD) package was in use by 
1972| and was used for the design of 
Renault bodies throughout the ‘70s. 


except that the output is now in three 
dimensions so some translation of the 
output is also required to produce a two- 
dimensional screen image (such a 
program is included on the magazine disc 
as Bezier4. Since matters are getting more 
interesting, the program contains a little 
extra code to allow several patches to be 
drawn). 


We can build on what we know for 
curves to produce a formula for patches: 
a 3 

P(u, v) = S X Py Bi, 
i =0 j =0 

The blending hmcticn is the same as was 
used before. Note that we now have two 
parameters, u and v, and two cubic 
equations, so we have a bicubic 
parametric patch. This is remarkably 
similar to the formula for the curve, 
except that we have two variables u and v 
which vary between 0 and 1 , There are 
now IG control points arranged in a 4x4 
matrix, and these relate to the patch as 
shown in figure 4. The comer points. Poor 
P 30 , Po 3 and P 33 , are, like the end points 
of the curve, on the surface of the patch, 
the other points exert a pull on the surface 
to produce the required shape. 



This can be programmed as an 
extension of that used to draw a curve, 


As before, such a program is very slow, 
and thus impractical, so we shall devise a 
subdivision algorithm, which is also where 
things start to get complicated. 



Figure 5. Patch subdivision 


Draw out the control points of the 
patch on a flat surface, to make life easy, 
as in figure 5a. Using the same technique 
as for curves, we can split the rows of 
control points, in u, into two, to produce, 
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notionally; two long, thin patches as shown 
in figure 6b. Now we take each of these 
thin patches and split them along v, or 
along the columns of control points, and 
produce two square patches for each long 
thin patch (figure 5c). So one large patch is 
divided into four small ones. To draw the 
patch all one does is to draw the square 
connecting the comer control points. 

The program which does this Oisting 6) 
is really very simple considering the 
output from it. It is not lightning fast, 
hut it is in Basic, and it does show what 
can be done. The version on the 
magazine disc includes the (much 
longer) data for that universal test 
object, a sphere. 

Again, Flatness can be associated 
with a patch, but this produces tears in 
the patch (figure 6) as not all of the 
patches are being divided equally. This 
is overcome by post-processing the 
image for the holes (which appear as 
small black regions on objects which 
have been shaded). A second program 
looks at the screen image finally 
produced, looking for the holes and 
filling them in. Although this sounds like 
cheating it works. I shall leave this as an 
exercise for the reader. 



Figure 6. Tears formed by non-uniform 
subdivision 


A further version of listing 6 (the 
program BeiierS) is included on the 
magazine disc. This allows a choice of 
object from data definitions kept in a 
separate file (created with Edit). The 
model of the Utah teapot (see figure 7), 


developed by M. Newell in 1975, is an 
object which has become a benchmark in 
computer graphics. Its curves and holes 
provide the ideal way to test shading 
algorithms to the limit, and it is also 
infinitely more interesting than spheres. 
It consists of 306 co-ordinates (3D) 
composed into 32 patches, arranged in 4 
groups - the body, lid, spout and handle. 
It^s just a shame the lid doesn't fit 
properly (you can alter the data easily to 
make it fit)! 



Figure 7. The Utah teapot 


So there you have a short trip through 
the world of Bezier curves and patches. 
The routines presented are crying out for a 
machine code implementation as they are 
so simple. I have used real numbers for the 
calculations as the data for the Utah 
teapot comes as such, but the routines 
work equally well with integers. You may 
like to add hidden surface removal to a 
patch, i.e. divide only if the patch is visible, 
or shading which does have some problems 
in that triangle-shaped patches have two 
comer control points the same which gives 
a surface normal of zero (see the sphere or 
teapot lid). 

So where can you go from here? A 
starting point would be to alter listing 5 to 
allow for non-uniform subdivision and 
investigate the problem of tears, but that 
is just an idea. Play with the objects and 
find out why most 3D packages, to date, 
use polygon mesh models. 
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References: 

Wattj Alan (1989); Fundamentals Of 
Three-Dimensional Computer Graphics 
(ppJ15-139). 

Burger, R, Gillies D, (1989); Interactive 
Computer Graphics - Functional^ 
Procedural and Device-Level Methods 
Cpp.241-283), 

My thanks to Ste Maddock, University of 
Sheffield, for the ideas. 

Listing 5 

10 HEM >BezierS 

20 REM Recursive Subdivision 

30 REM Version Al.O 

40 REM Author Derek Marriott 

50 REM RISC User March 1991 

60 REM Program Subject to copyright 

70 : 

30 MODE 12 
90 GCOL 128:CLG 

100 S"2 :Rai Scale value for linage 
110 PROCsetupcontrol 
120 dist 1-30000:ORIGIII 640, 512 
130 PRDCinitvtrans {250, 60,60) 

140 DIM patch{3,3,3) 

150 Number-3 :REM Number of divisions 
160 FOR Count%=l TO Patches^ 

170 FOR ul-0 TO 3 
180 FOR v^-0 TO 3 
190 FOR plane%-l TO 3 
200 patch {u%,v%,planel)=V(P (Counts 
iU%,v%),plane!) 

210 NEXT 
220 NEXT 
230 NEXT 

240 PROCdrawBez (pat ch (), Huinbe r) 

250 NEXT 
260 END 
270 ^ 

280 DEF PROCdrawBe£(P(),N) 

290 K>CAL Topleft (), Topright (), Botleft 
(),Botright 0 

300 DIM Topleft (3,3,3),Topright(3 1 3,3) 

, Botleft{3,3,3),Betright (3,3,3) 

310 IF N=0 THEN 

320 PROCdrawpatchiPO) 

330 ELSE 

340 PROCsplitpatch(P{),Topleft{),Topr 
ight 0,Bctleft(),Botright()) 


350 PROCdrawBez {Topleft 0, N-1) 

360 PROCdrawfBez (Botleft Or N-l) 

370 P ROCdr awBe z (Topright(), N^l) 

380 PROCdrawBez(Eotright(),N-l) 

390 ENDIF 
400 ENDPROC 
410 ; 

420 DBF PROCsplitpatch (P{),RETURN Topi 
eftOrRETURN Topright (), RETURN Botleft () 

,RETURN Eotright 0) 

430 REM patches (3,3) 

440 LOCAL BigPatchO,splitplan 
e!rleft(), righto 

450 DIM BigPatch(6,6,3),left (3,3,3),ri 
ght(3,3r3);REM Holds total grid 
460 PROCsplitInU(P{),BigPatGhO) 

470 FOR split!=0 TO 3 
480 FOR V!-0 TO 3 
490 FOR planel-1 TO 3 
500 left(split!r V!r planeI) =BigP atc 

h(spliti,V!,plane!) 

510 right (split!,V!,plane!)-EigPatc 

h(3+split!,V!,plane!) 

520 NEXT 
530 NEXT 
540 NEXT 

550 PHOCsplitinV (left (), BigPatch {)) 

560 FOR splitl-O TO 3 
570 FOR U!=0 TO 3 
580 FOR planel-1 TO 3 
590 Topleft(U!,Split!,pianel)=BigP a 
tch{U!,split!,planel) 

600 Botleft(U%,splitI,plane!)=EigPa 
tch(Ul,3+splitI,plane!) 

610 NEXT 
620 NEXT 
630 NEXT 

640 PROCsplitInV(right(),BigPatch()) 
650 FOR split!“0 TO 3 
660 FOR U!-0 TO 3 
670 FOR planel=-l TO 3 
680 Topright (U%, split!, plane!) -BigP 

atch(U%, split!, planel) 

690 Eotright (U!, split!, plane! )-Bigt 
atch (Ul, 3+split I, plane!) 

700 NEXT 
710 NEXT 
720 NEXT 
730 ENDPROC 
740 : 

750 DEF PROCsplitInU{patch() rRETURK Bi 
gPatchO) 
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760 REM A Patch into a 7,7 matrix 
770 REM u >,v 
780 WCKL V%,planel,C 
790 FOR V^-0 TO 3 
800 FOR plana^-l TO 3 
BIO C-(patch(l,V%,plane|) + patch(2, 
VI,planed))/2 

820 BigPatch(0,VI,planel) * patch{0, 
VI,planeI) 

830 BigPatcli(l,Vl,planel) = (patch (0 
,Vl,planel) t patch (1, VI, planelj )/2 
B40 BigPatch {2, V|,planel) - (EigPatc 

h(l,Vl,planel) + 0/2 

850 BigPatch(6fV%,plane%) = patch(3, 
Vl,planel) 

860 BigPatch{S,Vl,platiel) - (patch (2 

,Vl,plane|) + patch(3,Vlrplanel))/2 
870 BigPatch(4,V|,planel} = (BigPatc 

h(5,VI,planel)+ C)/2 

880 EigPatchO, Vl,planel) = (BigPatc 

h(2,V|,planel) + BigPatch{4,Vl,planel)) / 
2 

890 NEXT 
900 NEXT 
910 ENDPROC 
920 : 

930 OEF PROCsplitInV {pa tch(), RETURN Bi 
gPatch{)) 

940 REM A Patch into a 7,7 inatrix 
950 REM u >,v ^ 

960 LOCAL m,planel,C 
970 FOR Ul=^0 TO 3 
980 FOR paane%=l TO 3 
990 C= (patch(HI,1,planeI) t patch( 
Ul,2,planel)^/2 

1000 BigPatch(Ul,0,planel) ^ patch(U% 

,0,planel) 

1010 BigPatch(UI,l,planel) = (patch(U 

%,0,planel) + patch(UI,1,plane!))/2 
1020 BigPatch(Ul,2,pianel) > (BigPatc 

h(m,l,plane|) + C)/2 
1030 BigPatch(U|,6,planel) = patch(Ul 

,3,plane!) 

1040 BigPatch(U!,5,pianel) - (patch[U 

|,2,planel) + patch (tJl, 3,plane!))/2 
1050 BigPatch (U!, 4, plane!) = (BigPatc 

h{U!,5,pIanel) + C)/2 
1060 BigPatch(U!,3,planel) = (BigPatc 

h (Ul,2,planel) + BigPatch(Ul, 4,plane!))/ 
2 

1070 NEXT 
1080 NEXT 


1090 ENDPROC 
1100 : 

1110 DEF PRDCdrawpatch(P()) 

1120 REM P has vertices in it 
1130 PROCmove3D(P(0,0,l),P{0,0,2),P(0,0 
, 3 }) 

1140 PROCdraM3D(P(3,0,l),P(3,0,2),P[3,0 
.3)) 

1150 PROCdraw3D(P(3,3,l),P(3,3,2),P(3,3 
,3)) 

1160 PROCdlraw3D{P(0,3,l),P(0,3,2),P(0,3 

. 3 )) 

1170 PROCdraw3D(P(0,0,l),P(0,0,2),P{0,0 

. 3 )) 

1130 ENDFRX 
1190 : 

1200 DEF PR0Cn]iove3D(x,Y,z) 

1210 REM moves absolute line in 3D 
1220 PROCpoint(x,y,z):MaVE XE,ys 
1230 ENDPROC 
1240 : 

1250 DEF PROCdraw3D(x,y,z} 

1260 REM draws absolute line in 3D 
1270 PROCpoint(x,y,z)iDRAW xs,ys 
1280 ENDPROC 
1290 ^ 

1300 DEF PROCpoint{x,y,z) 

1310 HEM xs,ys contain 2D screen coord 
1320 FRO(2vtrans{x,y, z) 

1330 ENDPROC 
1340 : 

13S0 DEF PRXinitvtrans (rho,theta,phi) 
1360 REM Initiates viewing matrix 
1370 LOCAL st,ct,sp,cp 
1380 st-=SIN(RAD(theta)) 

1390 ct=COS(RAD(theta)) 

1400 sp“SIN{RAD(phi)} :cp<OS(RAD(phi)) 
1410 va=-st :vb“Ct :ve=-ct*cp:vf-^Et*cp 
1420 vg-sp:vi-''Gt*sp:vj“^st*sp 
1430 vk=^cp: vl=rho 
1440 ENDPROC 
1450 : 

1460 DEF PROCvtrans{x,y, z) 

1470 REM Perform transformation 
1480 xe=va*x+vb*y 
1490 ye=ve*x+vf*y+vg*z 
1500 2 e“vi*x+vj*y+vk*z+vl 
1510 PROCperspect(Ke,ye, ze) 

1520 ENDPROC 
1530 : 

1540 DEF PROCperEpect(xe,ye,ze) 

1550 xs=dist!*xe/ze:ys=dist!*ye/ze 
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Bicubic Parametric What? 


1560 

ENDPRX 

1770 

REH Add oiore if you so desire 

1570 


1780 

REM 16 vertices for one patch 

1580 

DEF PRXsetiipcontrol 

1790 

DATA 

16, 

1 


1590 

LOCAL N%,M%,Vert|, Count % 

1800 

1 




1600 

READ Verticesl,Patchesl 

1810 

REM Vertejc No, 

X, y, E 

1610 

DIM V {Verticesl, 3J, P (PatchesI, 3,3} 

1820 

DATA 

1, 

0,0, 

0.0, 0,0 



1330 

DATA 

2, 

0,0, 

0.8, 0,0 

1620 

FOR H^-^l TO Vertices^ 

1340 

DATA 

3, 

0,0, 

1.6, 0.4 

1630 

READ Vert%,V(N%,l),V{N%,2),V(M%,3 

1350 

DATA 

4, 

0.0, 

2.4, 0.0 

) 


1860 

DATA 

5, 

0,8, 

0.0, 0.0 

1640 

V(N%,l)=V{m,l)*S:V{N^,2)^V{m,2) 

1370 

DATA 

6, 

o.e, 

0.8, 0.0 

*S:V(Nlr3)=V(N^,3)+S 

1880 

DATA 

7, 

0,3, 

1.6, 0.0 

1650 

IF Vert^om THEN PRINT^’Error in 

1890 

DATA 

B, 

0,8, 

2.4, 0.0 

table '■ 

’:END 

1900 

DATA 

9, 

1,6, 

0.0, 1,0 

1660 NEXT 

1910 

DATA 

10, 

1.6, 

0.8, O.G 

1670 

FOR Count1=1 TO Patches1 

1920 

DATA 

11, 

1,6, 

1.6, 0.0 

16B0 

FOR N^-0 TO 3 

1930 

DATA 

12, 

1,6, 

2,4, 0.0 

1690 

FOR Ml=0 TO 3 

1940 

DATA 

13, 

2,4, 

0,0, 0,0 

1700 

READ P(Count|,N^,m) 

1950 

DATA 

14, 

2.4, 

0.3, -0.2 

1710 

NEXT 

1960 

DATA 

15, 

2.4, 

1.6, 0.0 

1720 

NEXT 

1970 

DATA 

16, 

2,4, 

2.4, 0,0 

1730 NEXT 

1980 





1740 

ENDPROC 

1990 

REM Define how patch is rnade up 

1750 


2000 

DATA 

1;2. 

.3,4,5, 

,6,7,8,9,10,11,12,13 

1760 

REM Define a single patch 

,14,15,16 





Archimedes Vo/ce Generator 

oTEACMINQ MUSIC oVOICES FOR MUSIC 

OTEACHING SrXJND oSOUND F&l QMIES / DEMOS 

Create an unlimited range of different sounds & instruments 
by means of /?arirT7ontos, Interpoiation, enveloping, and more! 

'AVG pttovldes an esdenslve range of tocAs with which toinanipulate scund. After 
extensive use I oon oonfiim thoT this is a small paioe to pay for such a detailed 
pleoe qI softwcue' ACORN USER (Feb '90) 

'AVG is an ejcoeltent pceckc^e and does it's best to striJce a balanoe betweeo 
oompleodly and versatility,.., A superio toci for anyme wishing to expehment with 
sound samples oi wavetemi and envestep© generalten.' 

MICRO USER (May 90) 

'AVG provides a tremendous wealth of fcfcilitles for VOCE creation. . I hove 
seldom seen a padione which is so oompiehensive aivi has so much to oiler in 
its field' 

RISC USER CJul'90) 

ALL I?DRJUST £ 59.95 (INC. PScP) 

AvaUtNe dlreci or horn AVP or BEEBliG (ofderoocte 5458). 


MJD SOFTWARE 

13 BURNHAM WAY 
LONDON W139YE 
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PipeDneam 3 breaks down the banriers between word processor, spreadsheet and database. You can 
include numericai tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 

Based on PipeDream 2, the best-selling integrated package for the Archinnedes, FipeDream 3 has been 
completely re-written to lake full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3,11 i s fu 11 y mul ti -tasking a nd mul ti-windowing, so you can work on many documen is a t once and i nsta n tly 
move in formation between thenn. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 


Power^r fleKibitity, speed, ease of use. FipeDream 3. Breaking down the barriers. 

For a free brochure, see your Archinnedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT, 


Mdjar r?iilTJTC» incLud^i: 

• many documents loaded a I orce 

■ irttuitiive RISC OS us^r interface 

■ displaying and printing 
of pictores text 

• built-in 53,003 word 
spoiling checker 

• flic compaUbihty with 
PC & ZSS PipeDream and 
BBC View Professional 

• background recalculation 

• keystroke compatibility 
with ZftS & PC PipeDream 

• ZS8 filing system 


automatic loading of VIEW, 

ViewSheet, Lotus, First Word 

Plus, Tab and CSV files 

automatic saving of VIEW, 

Lotus, Acorn DTP format, Tab 

and CSV files 

multi-field sorting 

use of aU availabJc fonts 

&2 spreadsheet functions 

external references for 3-D 

modelling 

macro file recorder 

slot protection 


I For a free t^oebure. complete an^i return this coupon , 
I PipeDream 3 □ View Professional □ ' 

I Name__ \ 

[Address_ i 


I Colton Softwaie. Broad'ivay tloLise,l45-lSl St. Nenti| 
■ Road, Hardwick. Cambridge CB 3 7 QJ. England. | 
1^:0954 211607 Tek 0954 2 l 1472 _j 


AT^ rnutTmart: MifsKiyviitJftd, 771; 4 w ttn Krtt" fhaam abme huh pmduced by .liftidjftj f*0M Pi^Ot-utri J Jij Pfoenter i snd Cfixn Jcviiif fbtf 

twb iftia pifK^nan 5. 

Colton Software, Broadway House, 145^151 St. Neots Road, Hardwick, Cambridge, CB3 7Q|, England. 
Fax, 0954 211607 Tel. 0954 211472 














Introducing C - 

Part 8: Command line arguments, dynamic 
memory allocation and bit variables. 

by Dec McSweeney 


COMMAND LINE ARGUMENTS 

The complex topic of using C to interface 
with, the Desktop will he tackled at length in 
a forthcoming series of articles. In the 
meantime 1 will explain the more 
conventional way of invoking C programs. 
This involves typing the name of the 
program at the * prompt, for example: 

*tiiypiog ugl U92 

This would cause the program *m 3 rprog' 
to be loaded and run (provided it existed in 
the current directory or the library). j4r^J 
and arg2 are 'command line arguments, 
which are passed to the program by the 
operating system. But how does the 
program get hold of them? 

Up to now, when example programs have 
appeared in this series, the function main 
has been followed by empty parentheses or 
the word voi<L However, main can have two 
arguments. The hrst is an argument count, 
the second an array of char pointers, each 
pointing to a word on the command line. By 
convention, these two arguments are known 
as argc and argv respectively, and who am I 
to fight convention? The full prototype of 
main now reads: 

<typfl> saln(int argc^ char ^exgvf]) 

where <type> would be 
void or int or whatever. 

The second argument, by 
the way, reads “an array 
ctrgvlJ of type 'ckar 
Mastering the art of 
interpreting complex 
declarations is an 
achievement of no small 
difficulty - take my advice 
and stick to the simple 
ones wherever possible). 


contents of argvlO] will always be the 
program name as entered at the keyboard. 
This allows you to detect if the directory 
path was used, if you really want to know 
(and I dare say there's scope for a spot of 
software protection here). A word is defined 
as a string of characters bounded by 
unquoted white space. Thus: 

hello mm /* ergo ■ 3 */ 

hut: 

nypxog num'' ergc * 2 */ 

Successive entries in argvf] will point to 
successive words on the command line. As 
with most things, C trusts the programmer 
to stay within the bounds of the array. And 
here we come to another rich source of 
errors in C programs; the number of 
arguments after the command line and 
subsequent program name (held in argu[0]) 
is thus one less than argc as : the first 
effective argument is argvll] and the last is 
argvlargc-1]. I've told you now, so don't 
blame me! 

Here's a brief example of a program 
which takes arguments: 


/* ctlc.c - prints the result of eritlawtlo »pr«etlcn In */ 
/* ergunente 1-3, e.g. oelc 75 / 15 would print 5 V 

/* Ibitten by Deo UoSweeney 1991 */ 

iincludi <>tdio.l]> 
flnclude <etring.h> 

tinclude <etdlib.h> ' 

int m»ln(int ergo, char *ugv[]l 
{ 

int opl, op2? 

i 

If (argc !- 4H I 

fprintfletderr, 'Urong nuo^er of «rgonMntt\n"); 

«rlt(l)F 

1 

opl ■ ictol(exgv[l]l; 

/* function etoitetr) retume int velue of string 

Corn, overleaf j 


argc will always be at 
least 1, in the case where 
the only word on the 
command line is the 
program name. Thus, the 
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op2 • atoi(argT[3]); 

■vltch(*azgT[2])( 

caM 

prlntf(’'%d\n^ opl ^ op2); 
bcaak; 

CAM 

prlxitf (”%dVn”, opl - op2); 
braak; 

caat 

pcixxtf ("IdNo”, opl * op2); 
braak; 

caaa 

prl 2 itf("%d\n", opl / op2); 
braak; 
dafault: 

fprlntf(ttdarx, "QQknoim oparatioD"); 
braak; 

) 

) 


Note how the switch statement uses 
*argv[2J, that is, the character pointed to by 
argv[2] (each entry in the array argv[ 7 is a 
pointer of type c/iiir remember), while atoi 
takes as arguments the pointers themselves. 

If you’re getting the hang of C you could 
try amending the program to take real 
aurguments, using atof[) instead of atoi. The 
program ought to check argv[3J for zero 
before dividing, and if you can include sqt 
from part 1 you can have a gold star this 
month! 

The arguments above are positional, 
that is they must appear in a fixed sequence 
and their meaning to the program is 
indicated by their position. More normally, 
at least some of the arguments will not be 
order-dependent and in the case of a 
program with many options could be quite 
numerous • think about writing a C version 
of the RISC OS *COPY command. 

The ususd way to handle such a situation is 
to process each argument in turn using a for 
loop: 

for(nsl; fKazgc; n¥*){ 

/* ... argv[n] pzootifllng .. */ 

) 

Observe that n starts at 1, but the 
terminating condition is n<argc, so the last 


iteration processes argvfargC‘1], For a 
command like *COPY the first two 
arguments would be positional (and 
comnulsory), but the remainder could 
appear in any order. In such a case the 
program would validate for at least two 
arguments (arge >= 3) and the for loop 
would start at the first optional argument. 
Optional parameters should be set to their 
defaults first, then reset if mentioned in the 
command invocation. Mandatory 
parameters can be set to invalid values first, 
then checked for valid values after all the 
arguments have been processed. 

SOME USEFUL FUNCTIONS 

The standard C library contains a large 
number of useful functions. Many, such as 
the input and output routines, have 
already been discussed. One group of 
functions that has not been covered is 
concerned with the dynamic allocation of 
memory. 

In a multi-user operating system such as 
UNIX, or a multi-program environment 
such as RISC OS, it is important that 
programs do not take up more memory than 
necessary. If your word processor is to be 
used for a short letter, it doesn’t need 
enough memory to store a novel (1st Word 
Plus please note!). In the same way, it is 
frustrating if a program imposes 
unnecessary limitations on the user. One 
popular word processor runs on the IBM PC 
(a 640K machine), but will only cope with 
documents of up to 32K! 

The easiest way to cope with this 
problem is to provide the program with 
memory when it needs it, and to claim it 
back when the program finishes with it. The 
functions malloc() and free() provide this 
fadhty. 

The full prototype of malloc is: 

void •); 

This means that malloc returns a pointer of 
type void. A void pointer is simply a 
mechanism for converting pointers from one 
type to another using casting. So, if the 
memory is required for a character array, 
the function would be called thus: 
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Remember that size_t is an imple¬ 
mentation-defined variabie type which 
is used for variable sizes. The C function 
sizet^) is useful when using mn/ioc: 


If a block needs to be enlarged, 
the function realloc will attempt to 
provide extra space. This may 
involve a malloc for the new size 
followed by a copy, so the value of 
the pointer may change: 


One approach is to use ^define to set up 
bit-values. Returning to the *COFY 
example, options could be defined as powers 
of 2, corresponding to a bit: 


bFti:-->tC!rt K {char *]09*lloc(bl.oclMii£e); 

To release a block of memory, the 
function freeO is used: 

/* imlinik txom the ohaia */ 
b{)tr-‘>n*xt->prev ■ bptr->fjext; 
tiftr->pr«v->oeit “ b^i^->pEev; £ie®(bptrjf 


Once the size of the block is established, 
mulloc can be used to allocate the text area: 


Bize t block size; 


td«fin« FORCE_C(VERIIEtira 1 
fd*£la« tStXM SOOBCE 2 
tdaf Ina VSRSOK 4 

/* ... and BO on V 
int q»tioDs; 


Tb set a flag, write: 


/* k portabU call to nliia tpac* for 1000 inte^firs */ 

/* Hbb slst of typo int variu ftom michtne to oadiinft */ 
int *iax^)ex9; 


mnbert^tint *}iulloc(lDO0 * Bliftof(lnt)] ; 

If malloc cannot daim sufficient space from 
the operating system it will return a nuU 
pointer. 

The structures discussed in part 6 are 
ideally suited to the use of malloc. A typical 
structure representing a block of text in a 
word processor might look like this: 

struct block ( 
thBE 

struct *block 
struct ^block next; 

1; 

struct *block bptr; 

To claim more memory as extra lines are 
added: 


bptE->cuKt B (struct block *)iBalloe(tiz«of{«truct block) 1; 
/* lisle tbs MW block to tbo daln */ 
i^x->fii(xt->pE«iT bptr; 
bptr=bp£t->iioxt; 

bptr->ncxt = HDIL; /* this is tbs sod of ths chi in */ 


One limitation of these 
standard functions is that the 
spare memory can become 
fragmented, and while there may 
be sufficient memory there may not 
be a large enough contiguous 
chunk to service a request. 


Furthermore, Acorn^s implementation 
provides memory from the amount allocated 
in the program*B original Wimpslot. Once 
this is used up, malloc will return null 
pointers (implying no more memory), no 
matter how much there may actually be, 
RISC OS applications may use a family of 
functions found in flex.h and heap.k which 
sidestep these problems (but reduce 
portability). 

BIT VARIABLES 

If you use flags extensively in your 
programs and you*re coming from an 
assembler background, you might not like 
the idea of using a whole integer (4 bytes in 

_ Acomsoft C) to store a simple yes- 

xk)l 

1 no value. If your programs are 
huge, you might not have room! In 
a well designed language it should 
be possible to store a flag in a 
single bit, and this is true in C, 
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Tb unset it, use: 

optloni ^VEBBOBE; /* U* ll tb* bltwlM MID */ 


names will be unique to the compiler - 
in this case Acornsoft*a ANSI C 
release 3* The principles will apply to 
any oompilen 


This uses a new operator: the tilde C-) which 
means NOT in bitwise opterations. Note also 
the use of the <op>= shorthand, 

Tb test such a flag, you would write: 

i£((options S VERBOSE) « 0) 

/* i.s. if VERBOSE ii off */ 

However, C allows you to define a structure 
containing bit-fields: 

struct ( 

unsigned Int forcejwenRrltt : 1; 
unsigned int dBljete_souroe ; I; 
unsigned Int verbose : 1; 

1 oopyjJptions; 

The width of the field in bits is spedfied 
by the number after the colon. In this 
example, capy_options contains three one-bit 
fields which you can access in the same way 
as any other structure member; For 
example: 

oopyjTptlons,verbose « I,' 

i£[oopy_j^lanstdelftte_iource » 0) 

You should check your compiler's 
documentation for information about the 
way bit fields are implemented. Such factors 
as alignment and order of allocation will 
vary from one compiler to another. In 
Acornaoft C, for example, copy_options 
would occupy an int and force_overwrite 
would occupy the least significant bit. For 
the sake of portability you should not rely 
on a particular compiler's foibles, 

USING SWIs 

A feature of the Archimedes is the well 
documented interface to operating system 
routines. In Basic this is achieved with the 
SYS command, in assembler, SWI. Of 
course, C also provides a way of accessing 
them. Naturally enough, what follows is 
specific to RISC OS machines, and the 


A header file, kernel, contains function 
prototypes, Udefines and other relevant 
data, but there are possibly better 
alternatives in RISC_OSUb (see the future 
series on programming the Wimp in C), 
which contains many 'packaged' SWIs. 

Information is passed to and from SWI 
routines in the registers 0-9. These are 
defined as a structure Jternel_swi_regs in 
the kernel.k file. In your program you 
should include the following lines: 

flnclnde <lcieRwl.h> 

_k«Miel_»iri_ngi ay_r«gm; 

Individual registers are treated as ints and 
accessed as in this example: 

nyngs.xlJ] ■ 1099; 

Registers are often used to hold the 
addresses of (or pointers to) character 
strings or other blocks of data. C is well- 
suited to this requirement. The address of 
any variable is given by the operator or 
in the case of arrays by the unsubscripted 
array name: 

Cihar ne»ss9i[503; 

•tmct edit^lina; 

i^_regs.r[D) > (iisb)aMsuge; 

c^jtegt,r[0] a (int) fiedlt^line; 

Pointers are cast as integers, which is the 
type of the register array elements. You can 
even pass the address of a “character 
constant" or “string literal": 

aqr^iegs-rtO) « (Int) "This li ■ literal"; 

To actually call a SWI, use the routine 
Jiernel_swi: 
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Ji£rael_«tH. (int •tfi_ 


_kexn«ljt«l_z«gs *lii, Jco£iial_svl_zegi *oi3t) 


The SWI numbers are fined in swis.h so 
you can refer to them by their nameSj for 
example: 

finclude <ivie.li> 


This topic will be 
covered in con¬ 
siderably more 
detail in a forthcoming series on 
programming the Desktop in C. In the 
meantime, here is a short program to 
display any portion of the time/date 
display, in much the same way as the 
UNIX utility “date”. 


/** dit#,c - print any portioa of the "TiiDt" laessage in any **/ 
/** specified foimt (set PRM for key) **/ 
/** Exoiple: date "%!£, UK) the would print **/ 
/** ‘'Tuesday, Deceofi>er the ZSth" **/ 


/** Kads In England by Dec HcStreeney, progrmoer to the grotty *♦/ 

tinciuda <stdio.h> 

fincliida <*tdlib*h> 

kincludi ^;exn«l.h> 

fincluia <svis,h> 

iitt mainflnt argc, *argv[]) 

{ 

char fbloGk[51; 
char out string [50] ? 
int a; 

Jce£iMl_Ewi_mgs r; 

/** First a call to 05_lCrd 14, 3 - ruad clock as S-byt« value 
/** ^ s 14 , e 1 k address of paruieter block (to bold result) **/ 

/** on antiy, Itt byte of rl is set to 3 (the ''reason ooda") **/ 

r.rl0]>14? 
r.rtl]=(int)|ihlock; 
pblo(A[0] - 3? 

(0S_1tord, fir, £e); 

/** on exit; phlock holds the 5-byte thae - caipate with a Basic **/ 
/** ccmnand "STS 07, 14, phlock TO , fW-OCk" **/ 

/** first we 4how the controts of phlock.... **/ 

£or[cp0; n < 5; n-H) 

pxlntf(''l02x ", phlocktn]); pEinb£(''\n"); 

How, we call Siri SCI to convert. argv[l] Is the dhar array **/ 
/** holding tba fonsat atring. For thia call the 5-byte block is **/ 
/** addressed via rd, the output string via rl, the foraat **/ 

/** string via r3. The length of output array is in t2« 

r«r[0]=^.r[11; 

r. r [ 1 ] a [int] out string; 

r.r[2]^; 

r.r[3]a(int)argv[l]; Jieinel_tvi(03jConvirtDateAz)dlfime; fir, Sr); 

printf ("tsXn", outstrlng]; 

exit(O); 


As it stands, the 
program will fall over 
if there is no format 
string in argv[lj, and 
does no validation on 
the format, so it relies 
on OS„ConvertDate 
AndTime to cope with 
any rubbish the user 
might type. 

Now you know 
how to do it, why 
not change date,c to 
report an error if no 
argument is present, 
or even to use a 
default string 
clever types could 
use OS_ReadVarVal 
to access 

SYS$DateForm at, 
or call OS_Convert 
StandardDate 
AndTime (SYS &60) 
which uses 
SYS$DateFormat 
instead of r3, A really 
user*friendly version 
would print helpful 
information if argv[lj 
was missing, invalid or 
set to “T. 

Have fun! 


Tkat*s it for this 
month. Next time I 
hope to wrap up the 
series by tidying up a 
few loose ends and 
taking a look at the 
compiler. 
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mis 

1 

THE WORLDS 


m 

MOST POWERFUL 


m. 

MICRO 

A3000 

£599 

SPfCiAL OFFER 

Buy an A3000 and get an 

410/1 

£1099 

extra IMB RAM fitted for 

420/1 

£1699 

only £50 or a free A3000 

440/1 

£2099 

Analogue & User Port 



Podule* Buy a 410 and get 

Learning Curve 

: £699 

an extra 1MB RAM free 


ARCHIMEDES PERIPHERALS 


Colour Monitor £199 

Mono Monitor £73 

A3000 

Monitor Stand £29 

User Port Bl Midi Pod. £49 

Serial Upgrade £19 

Ecoriet Upgrade £49 


300/400 SERIES 
Acorn Rom Podule £5S 

2 Slot B3CkpEar>e £37 

4 Slot Backplane £59 

I/O Podule £80 

Midi Podule £6B 


Secor>d 3*5" Drive £115 


ARCHIMEDES SOFTWARE 


PipedreamS £147 

RiscOs Companion £49 
1 St Word -I- £69 

Autodesk CAD £79 

Acorn PC Emulator £99 
Acorn Desktop Pub £149 
Clares Pro Artisan £145 
Clares Artisan £29 

Clares Toolkit £34 

Clares Toolkit + £43 


Tlhfs is a smaff 
SBfBction of the 
software that wo 
can soppfy ot 
competitive prices. 
Piease cait for 
any item you 
require. 


TELETEXT 


THE BIGGEST 
SELLING ADAPTER 

The Mortey Teletext Adapter 
IS now available for the 
Archirnedes. Advanced 
specif I catior>s, include digital 
tuning, screen dumps etc. 
Connects via the external 
podule socket or our 
Anatogue/User Port £125 



Existing users of our BBC 
Teletext Adapter can have 
the unit converted to an 
Archimedes version for£35 


FURTHER INFORMATION 

Our new catalogue will be available from mid August. We 
can also supply data sheets for most products. Please call 
or write if you require any of these. 


NEW IN STOCK 

MICROVITEC 
CUB3000 
MONITOR 
£199 

INCLUDING 
CABLES 

This is the new monitor from Microvitec that has been specially 
designed for use with all ArcNmodes computers. It comes 
in a rugged colour matched metal case with comrols for 
brightckesSn contrast and volume. The picture quality is very 
good and all the required cables are included in the price. 


full fittir^g instructions. 
You will be required to take 
the current drive out of the 
A3000 and replace it with 
the interface carrier board 
(unlike some add-on drives^ 
you can st’Jl use your internal 
podule socket). The original 
drive then fixes In the case 
with the second drive and 
the case is connected to 
the A3000 with two cables. 
As the connectors are 
detachablen th^ unit can be 
easily disconnected from the 
computer if the need arises. 

£125 


The kit and assembly are 
similar to our 3.5" kit except 
the case is larger and the 
mechanism is a high quality 
TEAC 5-25" drive. The drive 
(unlike some you can buy) 
is also buffered to Acorn 
specifications so eliminating 
the possibility of damage to 
your A3000 (buffering is not 
required for an additional 3-5" 
drivel. 

£159 


LEADS & MISC. HARDWARE 


SC ART Monitor Lead 

£8 

SQ col Printer Stand 

£15 

9 Way Msync Lead 

£8 

132 col Printer Stand £19 

Arch Serial Lead 

£8 

A3000 Monitor Stand £29 

Printer Lead 

£6 

Tilt Swivel Stand 

£11 

2 to 1 Printer switch 

£20 

Eprom Eraser 

£18 

3 to 1 Printer switch 

£30 

Eraser with Timer 

£23 

4 to 1 Printer switch 

£36 

5,25" Discs X 10 

£5 

64k Printer Buffer 

£115 

3,5" Discs X 10 

£10 

256k printer Suffer 

£199 

27128 Eproms 

£4*20 


A3000 5.25" 
SECOND DRIVE 



A3000 3.5" 
SECOND DRIVE 



The kit consists of a 3.5 
Inch floppy disc drive, data 
cabiej power cable, metal 
case (cream coloured), an 
Interface carrier board ar>d 





















O.N.I.C.S. L.T.D 


MEMORY EXPANSION 

THE BEST VALUE MEMORY UPGRADES 


lM5k9 mast other upgrades, otir fMB 
upgredeebh c^d cea be ttpgredod 
with enother 2MB f4MB teW hi 
machine) at a iater date for maximum 
ffexib^y. futherrmire, our cxd can be 
upgraded without throwing away tha 
memory that you akaady hava on the 
card. 


A3000 1 MB Expandable £99 

A3000 1 MB Non-Expandable £B9 

A3000 3 MB Upgrade C259 

A3000 T MB to 3 MB (free fating) £180 
305 1/2 MB £89 

400 Series 1 MB £99 

400 Series 3 MB £249 



Fully compatible with all Acorn software. 

A must for all serious Archimedes owners. 
Make full use of powerful RISC^S packages. 
Can use extra RAM as a second drive. 


*** NEW PRODUCT *** 

A3000 BBC Analogue + User Port Podule 



Full specification BBC analogue and user 
port. The analogue port is accessible 
using ADVAL from BASICS with all 
BBC OSbyte calls supported. 

£69 

Interface software written by 
Acorn for maximum 
compatibility wHh the BBC. 


ARCHIMEDES HARD DISK DRIVES 


*«4 NEW *** 

A3000 HARD DISK DRIVE UNIT 


SCSI HARD 
DISK DRIVES 


mr ERF ACE 


MTERFACES 


ST506 Podule Kit £149 

disk drives 

lndudlr>g ST506 Podule« 
cased drive with power 
supply, cable & leads 

20MB £399 

4DMB £499 

Larger Drives POA 

Compatible with Acorn's ADFS. 16 bit 
interface for extra speed. Drive mounted 
in separate coiour coordinated case with 
switched mode power supply and fan, 
Compfies with Acorn's new 
recommendations on BF emissions. 



A3000 SCSI Pod. £149 

300/400 SCSI Pod,£199 

SCSI DISK DRfVES 

Including SCSI Podde,^ 
drive, cable & leads. 
A3000 drives also 
inclixle case arvd power 
supply. 

A3000 20MB £4SB 

A3000 30MB £495 

A3000 40MB £575 

300/400 20MB £449 

300/400 30MB £499 

300/400 40MB £569 

Please call fcr prices on 
larger drives for A3000 
or 300/400 


MQRLEy 

E.L.E.C.T.R.O.N.I.C.S, L.T.D 

Morley House 
West Chirton 
North Shields 
Tyne Si Wear 
NE29 TTY 

Tel I091J 257 6355 
Fax f09lj 257 6373 


Shop houn: 

9am to 5:30pnn (Mon- 
Fri) Sam to 4 pm fSatl 

Acorn^ 

We are an Acorn dealer and 
service centre. If you would 
like tc have a look at the 
A3000 or any other Acorn/ 
Morley product please feel 
free to call in and discuss 
your repuirements with our 
staff. 


if there is 
anything you 
require which isn't 
advertised, please 
ring for a 
competitive 
quote. 

How To Order.... 


BY POST: Enclo^A chaqua 
mada payable to MORLFT 
ELECTRONiCS LTD. 

iV PRONE; By quoting your 
ACCESS or VISA card 
number. 

CARRtAOE: £1 on most 
orders. £3 on larcar itarr^s. 
Herd Disks, Conn|3uiefa + 
Monitors £10 Icarrierl. 

VAT: UK customef* please 
add 15% to cost incl. 
carridga. 

GOODS USUALLY 
DISPATCHED BY HFTURN. 

Govorrvnent and Education 
enders welcome- 

Acorn and Archimedes are 
trAdemarks of Acorn 
Computers Ltd. 





Hints & Tips... Hints & Tips 


iNSTANTSPRITE DISPLAY 

Lee Csicraft 

When editing an application spritej you can 
have trouble seeing the effect of yoinr work. 
Even once you have saved the new sprite, the 
old one will still be displayed as the icon for 
your application in its directory viewer. This is 
because the Wimp sprite pool still holds a copy 
of the unedited sprite. 

To update the Wimp sprite pool (without having 
to resort to a hard Break), use F12 to get to the 
command line star prompt, and issue: 

*IconSprites <pathrLame> 
where <pathnatne> is the full path to the 
application*s tSprites file, for example 
adfs:i).$.fMyApp.!Sprit€s. The new image will 
appear as soon as you return to the Desktop 
(by pressing Return). 

SHELLCLIINUSE 

Matthew Astfey 

On some occasions, the ShellCLl module (which 
allows you to invoke a command shell from a 
Wimp program) can give the error “ShellCLl in 
use”, and is unusable until after the next reset 
There does not seem to be any way of retrieving 
it, but an alternative is available - from the 
Task Manager, select New task from the menu 
and enter the star command you wish to issue. 
This can either be a one-off command, such as a 
compilation command or disc catalogue 
command, or a *GOS to go to the Supervisor. 
This is like the ShellCLl, except that you have 
to esdt with *Quit 

USING AUASSSHELLCLI 

Matthew Asttey 

The key FI 2 from the Desktop can be put to 
other uses. Whenever it is pressed, the Task 
Manager issues a *ShellCLl. If the system 
variable Alias$ShellCLI is set, that command 
is used. For example: 

*Set Alias$ShellCLI FX 138 0 130imshel 
iCLIfM 

would “press” key F2 and then go into the 
ShellCLJ as normal, but the string contained 
in Key$2 will be “typed” for you. If the 
ShellCLl is in use, or you prefer to go into 
Basic when you press F12, use: 

*Set Alias$ShellCLI Echo [|Z| |_|\%\ r 
I UlHBasiclH 

The Echo command (up to the first IM) puts a 
blank line at the bottom of the screen (but also 
creates a dialogue window in the middle of the 
screen), and then jumps into Basic* QUIT from 


Basic will give the usual “Press SPACE or click 
mouse to continue” message. The command 
*%ShellCLl sends the ShellCLl coimnand to 
the original ShellCLl module, as in the first 
example. 

MORE USES FOR ADJUST 

Lee Caicraft 

If you dick on the tide bar of a window with the 
Adjust button, you can move the window around 
without bringing it to the front of the stack. 
Moreover you can continue to move a window 
beneath another even though you cannot see the 
window that you are moving. Adjust can also be 
used on the adjust size icon without bringing 
the window to the top of the stack. 

FONTS AND VOICES 

Tony Shew 

The RISC User monthly disc for Volume 3 
Issue 3 contained several system fonts, and 
many more can be obtained “free” by searching 
through games discs (but you must not 
contravene copyright by distributing these). 
The filet 3 rpe may need to be changed to FF7 
(BBC font). Games discs are also a good source 
of sound voice modules. 

SUB’MENUSINC 

David Spencer 

If you are using the ANSI C compiler with 
RISC OS Lib to create a menu tree involving 
more than two levels of menu, you must attach 
the sub-menus in reverse order* For example if 
you have a tree of the form: 

Menu 

Sub-menu level 1 
Sub-menu level 2 

you must attach the level 2 sub-menu before 
attaching the level 1 sub-menu, or the task wUl 
misbehave when the menus are opened. 

PRINT TO FILE 

Aian Wrtgiey 

OS3yte 5 (or *FX5,n) sets the driver type for 
subsequent printer output (this can also be 
configured using *Configure Print n). The 
second parameter of the call, or the value of n in 
the ^Configure command, Is 1 for the parallel 
port and 2 for the serial port, just as on the BBC 
micro. However, if this parameter is greater 
than 2, RISC OS looks for a system variable 
with the name Printer'7)fpe$n (for example, the 
NetPrint module defines PrinterType$4). To 
divert printer output to a file therefore, set up a 
variable as in the following example: 
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■ *Set PrinterType$5 adfs::fiardDisc.$*Odd 
bits,Printout 

Then uae *FX5,5 to send any subsequent 
printer output to the specified file- This is very 
useful for testing printed output from your 
programs without generating reams of scrap 
paper. The file thus produced can be loaded 
into Edit for inspection, 

DRAWING STRAIGHT LINES 

Ivor Ciarke 

Drawing a straight line in Movie Maker, or 
indeed any drawing package in freehand mode, 
can be very tricky. However, by running the 
mouse along the edge of a box, a straight line 
can be drawn quite easily. Diagonal lines can 
be drawn by using the comer of the mouse on 
the straight edge. 

CONDITIONAL FUNCTION 
EXECUTION INC 

Lee Cafcran 

In C the following line will only cause myfuncQ 
to be executed if flag is false: 

if (flag 11 myfuncO) i++; 

The contrary is true in Basic: 

IF flag OR FWit^func then i+-l 
Here FNmyfuTic will be executed regardless of 
whether its value is to be used or not Here C 
appears to behave more effidently than Basic, 
since if flag is TRUE, the value of FNmyfune is 
irrelevant 

A similar thing occrxrs with the AND operator: 

if (flag i+'i') j++; 

Here i will only be incremented if flag is 
TRUE, since only in that case is there any 
need to look at i at all. Again Basic will look at 
all the elements in the Logical expression 

IMPROVING PRINTERDM FOR THE 
STARLC24 

A.E Taytor 

Using the Star LC24-10 printer with DTP 
packages and also with Draw, I noticed an 


occasional and apparently random mis¬ 
registration between successive passes of the 
print head, producing a “slewing" of the line of 
text, I was using PrinterDM with the printer 
definition set to Epson LQ800 (the LC24 
claims LQ800 compatibility). Eventually I 
traced the problem to a slight incompatibility 
between the LC24 and the LQ800. 

This can be cured by a small amendment to the 
PrData file, under the section for Epson LQ800 
compatible (360 x 180 dpi). Simply amend the 
following line: 

line_epilogue "<2 7 >$<0>< 0 ><2 7 >J<2 O" 
to read instead: 

linejepilogue '"<27>A<0><13><27>2<27>J<2 
4>" 

OPENOUTAND FILETYPES 

Lee Caicraft 

It is Bometimea convenient to set the type of a 
file used with the OPENOUT statement, and 
to do BO before the file has been cloBed. To do 
this, create a file of the required name, and set 
its type using *SetType (or combine both 
operations wi& SYS “OS_File”,lO), then use 
OPENOUT with the same filename. The filing 
system will open the new file using the file 
type used by the previous incarnation. 

FASTMOVE 

Leonard Hanson 

The FastMove module supplied on the 
magazine disc for Volume 3 Issue 7 is very 
useful for hard disc users. If you use the RISC 
User Dustbin, open up the !Dustbin directory 
and add the following line at the start of the 
!Run ^e: 

RMEnsure FastMove 0 RMLoad <0bey$Dir>,F 
Move 

Then save the FastMove module in the 
IDustbin directory as FMove. This change will 
reduce the time taken when deleting files, 
since Dustbin moves files by *COFYmg with 
the delete option set. ra ^ 


POINTS ARISING • POINTSARISING * POINTSARISING * 


PCOL 

Volume 3 Issue 5 (disc) 

Under rare circumstancee, mostly with some 
longer programs, a fatal crash occurs when 
using PCol. An updated version of PCol, 
which will cure this problem, is included on 
this month’s magazine disc. 


Introducing C (Part 8) 

Volume 4 Issue 3 

Note that the concluding element of the for 
loop on page 62 should be n- - (and not n- as 
it appeared - a result of subsequent 
processing). 


RISC User March 1991 


63 





ARE YOU GOOD ENOUGH? 

As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 

If you have written any programs, completed or not, then we would like 

to hear from you. 

If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 

If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 

Programs can be written in any languoge as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that It is needed. BASIC on the Archimedes Is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
VVhy not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 

The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 

Please write, in confidence, to Mr, D. Clare at: 

Clares Micro Supplies, 

98 Middlewich Road, 

Northwfch, 

CHESHIRE CW9 7DA 

If you have a program either complete or in development then please 
enclose a copy for our evaluation. 

To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 

Act today and become part of the leading software team producing 
software for the worlds fastest micro. 

























Postbag 


GAMES 

In response to Mr.Craig^s letter on adventure 
games (RISC User Mjlame 4 Issue 2)^ please 
note that Magnetic Scrolls are alive and well 
on Q71-403 4268 (they even answer the 
telephone as Magnetic Scrolls). V^th regard 
to the fatal bug in The Pawn it does exists or 
at least it used to^ as it has now been 
corrected. Users can send the original disc 
back to the publishers, IntermcdiateSt 
P.O.Box 847, Harlow, Essex CM21 SPH, tel. 
(0279) 860204 for a replacement. 

One problem which persists, and which I 
hope Magnetic Scrolls has taken heed of is 
that whenever the copy protection system 
asks for the word Kerovnia (probably once 
in every four times), it pretends not to 
understand the word, so saving fairly 
regularly is a good precaution. 

Mr.Craig does not mention any problems 
with Guild of Thieves, but I know for 
certain that there were a few which have 
been ironed out. The same rules for a 
replacement apply here as for The Pawn. 
One problem with all Magnetic Scrolls games 
to date is that they will not work with later 
versions of the C library module CLih than 
that supplied with the game. A simple 
solution is to press F12 and type: 

RMKill SharedCLibrary 
before running either game. Experienced 
users could probably alter the !Run file 
appropriately. 

With regard to the problems in completing 
the game, do not telephone Magnetic Scrolls 
because they enjoy keeping the solutions a 
secret Do not write to me either because Tm 
not good at them. Instead Join Official 
Secrets. This is a club primarily for 
Adventurers and is part of Intermediates. 
Club members enjoy the benefit of an 
adventure help line, and other assistance. 
The cost is £29.99 which includes a quarterly 
magazine, a bi-monthly glossy catalogue 
covering all games, and a choice of game 
from Fish!, Corruption, The Pawn, or 
Guild of Thieves. There is also a lower 
price Special Reserve membership without 
the help line for £6.00. 


As a final note, watch out for Wonder-Land 
early this year. Magnetic Scrolls* new 
adventure being published by Virgin. 

Nicholas Furness 

AND MORE GAMES 

Just a short letter to congratulate the writers 
ofHvinWorld. What a masterpiecel The game 
is a Joy to play from start to finish. Each 
evening when 1 get in from work 1 load up 
the game and try to improve on my final 
score of 55960. Never has such a great game 
been written for the Acorn range of machines. 
If this is what the standard of games 
programs on the Amiga is like, then where 
have the writers of Archimedes games gone 
wrong? 

Please, please, please can we have more 
ganws like this for the Archimedes. No time 
for any more, I still have the world to save! 

Nell Newman 

GERMANIA 

Alan Wrigley*s article in RISC User Vjlume 3 
Issue 10 is misleading with respect to the 
German keyboard. Every week my wife writes 
long letters to her mother in Germany. After 
loading 1st Word Plus, she presses F12 and 
types (at the star prompt): 

COUNTRY GERMANY 

Not only do the Z and Y change places but 
the entire keyboard adopts the German 
layout. The is to the right of zero, U to the 
right ofP, and Q and A to the right ofL. For 
a (^rman touch typist there is no further 
problem. 7b change back to the normal state 
type: 

COUNTRY UK 

at the command line prompt, being careful 
not to type COUNTRZ*. Alternatively, simply 
reboot the machine. 

David TayloF 

Alan Wrigtey replies, '^MrTaylor is quite right 
about German characters. \ thought t had 
tested both French and German before writing 
that particular paragraph in my article, but 
obviously \ only tried it out with the French 
alphabet, which does not have provision for 
accents on the keyboard. 
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Personai Ads (free to members) 


310 CMilmu'with 4]Vlb BAM and 40 
Mb disc, OC ROMBAM board. 
Acorn ANSI *C\ Programmers 
Reference manimU and software 
£1600. Tel (0268) 45281 exin. 2209 
between 0900-1700, 

Story writiiig; artificial creativity. 
Postal discussion/programming 
group proposed. Tony Kelly, C§n y 
Uoer, Pfamiers, Uanwrda, Pyfed. 

Canon FWIOBO-A printer as new 
with cable (cost £270) £90 plus 
carriage. Tel, (0275) 462979. 

Archimedea A3000 base with 
iMb RAM and RISC OS, 3,5" 
floppy drive etc, for only £650 
(unwanted gill 1 month old!) Tel. 
(0246)435555, 

Gamea Minipack N<i,2 fhnn CIS, 
contains Corruption, Conqueror 
and Quazer, NB these are originals 
not copies (unwanted gift) £11 the 
lot Tel 081-654 3733. 


BBC B & Tordi twin disc system 
with many packages, discs, 
magazines, books, cassette unit 
and li^tpen eic. £250. Tel (0304) 
853267. 

Archimedes 810 base unit with 
RISC OS, manuals, applications 
discs, 4 slot poduk backplane £450, 
Tel (058 283) 377a 

Archimedes 810 computer with 
twin disc drive, ooknir monitor and 
software £600. Tel. (0743) 248107, 

Epson LQ!2fi00 24 pin dot matrix 
printer wi^ dual bin sheet feeder 
bargain at£350. Td. 081^31 0716. 

Archimedes 410/1 SMb RAM, 
50Mb hard disc, Genificnn A5 mono 
scanner, Taxan 795 monitor with 
Vine, Linnet modem, manuals, 
lots of software. Offers in the r^on 
of £2200, Wil split, also Cumana 
5.25" disc drives and modems £20 
eadi. Tel 04867 80632. 


Philips paper-white monitor, 
model BM7522, excellent condition 
with original packaging £55. Tel 
061-969 9428, 

Complete workstation 1200mm 
bmich, Master 128, colour monitor, 
LKSOO printer, twin 5.25" Cumana 
driven perfect condition £650. Tel 
081^648276, 

Micro Peripherals MP165 
printer with NLQ facility, Epson 
compatible, hardly used (home 
environment only), complete with 
leads and manual etc. £100. Tel 
(05086)3517, 

Archimedes A3(H)0 still under 
warranty, new games, manuals, 
software and magazines £575. Tel. 
051^9456. 

WANTED: Acorn Atom computer 
in good woridng oonditiDn. Tel, 091- 
374 3631 day, 001-372 1797 eves. 


IPersonal Accounts 

AJOOO/Arc Special Edition 

Version 2 : £28.95 


* RiscOS Multi-Tasking Application 

* 28 Automatic Standing Orders/Any Period 

* 48 [ncomc/Payment Headings with budget columns 

* 10 Bank/Credit/Cash Accounts on-line 

* 20 Quick Entry Pre-sets 

* 3000 Entries per File 

* 50 Oiaractcr Descfiptioo Space 

* Full Scrolling Entries for easy inpul/edit/^ardi 

* Reports to Scrcen/Prinicr/File 

* Calculator.^oLc Pa4/Autosavc Sl Much More 

"Personal Accounts is very poweifut, good value for 
money, easy to use and comes highly focommended" 
Review of Version 1, Archive, November 1990 


Apricote Studios 

2 PiJiK hinn, Mitici. 1 , Oiinhs, Plll5 (INI) 

[jjj Tcl; 035 478 432 


Cambridge Infemational Software Ltd 
8 Herhrand St London WCIN IHZ 
0718334023 

ArcMonitor £24.95 

Professional disassembler, 10 breakpoints, 
mouse driven, RM, -i- many features, 
Supersounds £17.95 

4 disks of 'raw^ samples 
Mint pack S £29.95 

contains FISH, PON & FIREBALL II 
Mah-Jong Patience £19,95 

Fiendish version of Chinese patience vrith tiles, 
MteroDrive £19,95 

Much acclaimed 3D golf simulator. 

Crisis £17.95 

Maze game full of 'micons' and sounds. 

PIPP £49,95 

Cross-curricular project planner for Primary 
schools. Contains ALL AT statements, 
RiscType £19.95 

Architnedes Typing Tutor 
Fireball H £19.95 

World's greatest breakout game, 

VAT inciudedpkas^ add £1 p <5 p. All cards accepted. 
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Technical Queries 


CREATING BOOT FILES 

Dear Sir, 

/ have typed in a iot of your utiiities 
and now have around 20 of them. The 
icon bar gate so fuH that t have to scroii 
it sideways to access everything, is it 
possibie to create a second icon bar 
which i can bring up by clicking on the 
originaf icon bar? 

Stiil on those utiiities, f have to load 
them off my 'system’ disc every time / 
switch on. / have used iBoot Obey files 
with things like: 

^Desktop Ron ■House 

and that works fine, for the first utility. 
Piaying about with the IBoot file, I can 
get nothing more to happen. How do I 
get it to load, say, 20 Wimp programs 
and enter the Desktop property? 

Richard Murray 

First of all, it is just not possible to create 
another icon bar. It is possible to change 
the height of the existing icon bar, but this 
still doesn*t help as all applications so 
installed must occupy a unique position 
along the length of the icon bar. 

However, it is perfectly possible to create a 
boot system which will achieve what you 
seek, and load and install 20 Wimp 
programs leaving you in the Desktop, but 
this cannot be done with a single file. 
What you need to do is to create an 
application on your ^system’ disc called 
!Boot, Next use Edit to create a !Run file, 
to be saved in this application directory. 
Use this to set up any system variables (to 
set font path, run types etc.), and then 
enter as the last line of the !Run file: 

Desktop -file <BootSDir>.r>eskboot 
assuming that Boot$Dir has been set to 
<0bey$Dir> earlier. 

Then create a text file (filetype FFF) called 
DeskBoot with lines similar to: 

Run adfs::SystemDisc,$,!Edit 
Run adfs::SystemDisc.S.!Paint 
Run adfs: :SysteiiiDisc,$, iDraw 
etc. 


finishing off with the line: 

FilerjOpenDir adfs::SystemDisc.$ 
if you want to finish with the directory 
viewer for the root directory open on the 
Desktop. Finally don't forget to set the 
auto-boot option on the disc to: 

*OPT4,2 

Alan Wrigley 

RISC OS EXTRAS 

Dear Sir, 

My investigations revealed the 
ReadMe fiie in the ISystem directory of 
the Voiume 3 Speciai Disc which refers 
to RISC OS 2.00 Extras. I checked to 
find if these had been reviewed in RISC 
User but could find no reference. What 
emphasis do you piace on ha ving these 
'Extras’ installed? 

Geoff Steepef 

Where newer versions of modules or 
additional modules are required we 
include an appropriate copy of! System on 
RISC User magazine discs, and other discs 
(like the Volume 3 Special Disc) which we 
publish. A condition of Acom allowing this 
is that the ReadMe file referred to by 
Mr.Steeper has to be included, though not 
all the items referred to are themselves 
included. 

Effectively, these extras are updated 
versions of some of the applications and 
other modules supplied on the Applications 
discs with any Ar^imedes. By and large, 
if you are not encountering any problems 
then there is no great incentive to upgrade. 
The extras were referred to briefly in RISC 
User Volume 2 Issue 10, and published 
(with Acorn^s permission) on the RISC 
User magazine discs for Volume 3 Issues 1 
& 2, They are also available through SID, 
Acorn’s on-line bulletin board, and on the 
RISC OS Extras disc from BEEBUG for 
£4.40 plus 60p p&p. In addition, as already 
stated, the latest modules from ISystem 
are often included on other discs when 
required. 

Mike Williams 
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Software for 




Show Page is a PostScript compatible 
interpreter running under RISC OS. 

Over the last 6 years PostScript has 
established itself as an industry standard 
graphics programming language. 
Pioneered by Adobe for use in the 
original Apple laser printers, it is now 
used in all manner of output devices 
such as colour printers, and typesetting 
machines. 

Show Page will be attractive to those 
wanting to learn and explore this 
programming language and those 
wanting to print and use PostScript files 
from other machines. 

ShowPage is hilly multi-tasking and 
RISC OS compatible. It can read any 
PostScript file and output either to a 
window on screen, or to the currently 
selected RISC OS printer It can 
therefore be used to make even the 
lowest cost dot-matrix printer PostScript 
compatible. When used in conjunction 
with LaserDirect, it can turn this printer 
into a very fast and fully fledged 
PostScript compatible laser printer. 

ShowPage supports the colour 
extensions and can create a sprite file of 
any required size. It can therefore be 
used to incorporate PostScript graphics 
into other RISC OS applications. It uses 
the RISC OS outline fonts, rather than 
the conventional PostScript fonts, for all 


a spiral bound manuid detatUng 
SbamPagt version of tire language. 320 page PostScript 
iangui^e reference manual by Atb>be. 240page PostScript 
language tutorial manual by Adobe. Discs conta^ing 
SbowPage and example programs. AvanlG, BoobM, 
Pembroke RISC OS outline fonts. 


rendering, so it is 
compatible with the 
wide range of Archimedes outline fonts 
now available for this computer, 

ShowPage has a simple built in editor 
allowing PostScript programs to be entered 
directly, and interactively with the results 
shown on screen in another window. 

Showpage is compatible with the 
output from Acorn PostScript printer 
drivers. Minimum recommended memory is 
2Mbytes. 

ai71J5ind.) 


poliSenpi is a iradefnark of Adobe Systerns fnc 
















the Archimedes 
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An equation building tool that 
complements many RISC OS applications, in 
particular DTP and word processor programs 
such as Impression and Impression Junior, 

Many users of the Archimedes have a 
need to include complex mathematical 
formulae or equations into documents. 
Equasor allows equations to be built up on 
screen, graphically, from their component 
parts. Using the Acorn outline font system it 
presents a totally accurate view of the final 
equation at all times. 

It simplifies the building of equations by 
presenting palettes of symbols, functions and 
operators which can be selected just by 
clicking with the niouse. It intelligently scales 
and re-sizes features such as summation 
symbols, brackets, and square roots as the 
equation is edited so they are always the right 
size* 

Once the equation has been created it 
can be saved or exported to any number of 
compatible RISC OS applications. En DTP 
packages it can be dropped into frames just 
like any other drawing where it can then be 
scaled and positioned as required. 

When used in conjunction with 
Impression II, it can take advantage of the 
latter's embedded frame capability to embed 


equations into the text, even on the line. 
Once embedded in this way, the equation 
will then flow with the text as part of the 
text. 



Multi-tasking RISC OS application. Supports 
direct in-memory transfer of equations for the 
fastest, simplest integration with other RISC 
OS applications. Any number of equations can 
be handled at the same time. Equations can 
be viewed and edited at any scale. Saves 
equations as Draw files compatible with all 
applications that support this formal. Supports 
multiple different RISC OS outline fonts and so 
is not limited to the Math/Greek font supplied. 

• Supports region selection and cut, copy, 
paste between equations and 
documents, 

• Styles for global control over fonts, size, 
spacing etc. of variables and 
operatars.Effects give additional control 
over the appearance of Individual parts 
of an equation. 

• Small, compact program perfectly 
suitable for 1 Mbyte machines. 

Package incltutes a tid page spiral tound 
manual witP detailed tutorial rejerettce, and 
index. Discs include the program, example 
equations, and Math/Creek outline font. 


£49+VAT (156.35 incl.) 


m 

Computer Concepts Ltd 


Caddcsdcn Place • Hemel Hempstead * Hens * HP2 6EX • Tel. 0442 639S3 * Fax 0442 251632. 
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f^mRAmmmscusE^mMM ibbi 

HBBBb ^ ^ort mrnp appikatm which aikmyou to minify ary ^ 
Desktop as you msh 

Hard Dkc Ardii^ 

M An exce/ient utility for selectively backing up the contents of} 

disc onto dq^'es 

^Unn^M Watchdog Update 

^ MhUp ^ enhanced version of the updated program described in the 
m magazine giving addedprotecdon to your discs against viruses t 

Em J W other malpractices 

IJ Creating f^fessionaf Disc Lab^ with Draw 

SSiCT^ ^mple Drm dies shoving what can be achieved, and which can . 

used as ^msdates for other designs 
ffeeShts 

r | Use this program to aiiow the Task Manager to display continuousi, 

I updated information on asmilable free memory, 

f Mastering the Hdmp (Part IB} 

A demonstration of more efdcient techniques for window redraws 
A ^rstLank atBeihr Curves (Parti) 

Three programs to experiment with as described in the magazine, 
together with the data for the scxalled Utah teapot 
Introducing C (Part 8) 

Source and compiled versions of two example Cprograms described 
this issue. 

ADDinomi PftOOftAmSDCSaUBEDfNTm MAGAZINE 
m/DJP: Using the lEM Otaracter Set with 1st Word Pius 

The data die for the IBM character dednidons together with 
corre^oonding LCIO andLC24printer drivers andmodided IPun file u 
use IBM characters in IstmrdPlus 

I BONUSITEMS 
I Mom's New f^ter Drivers 

? Ihe other two printer drivers (referred to fast rrmnth): PrinterU and 

PfinterPS 

Desktop Todet 

A novH application mth appropriate sound allowmg you to 

flush avmy any unwanted dies 
Muld<ofumn Program Lister 

An updated version of thbpt^iar application whkh cures an obscw 
bug affecting the listifTg of longer programs 
Font Control 

An application from Acorn y Poger Wilson allowing you to create a d 
mapf^font for a given font size (for speed of access) andtochanc 
the values for the Fontmax andfontmaxi to fontmaxSparameters 


font Control 


Bezier Curves 


Disc Labels with Draw 





special Offers to RISC User M^tweire - Mar 1^1 ^ 

Each month RISC User wiU list of spedat prices sofw^v \; 

only to RISC U ■_ ^ 

Cede Pioduct^^^^^^em^^^tfce 


upgrade 


^ COIDER MEMBER 

These offers ^ av^blc for one month from publicatiofi! 


Sale of Laser Printers 

We have a number of 
ex*demoii5tratioii Qume and 
Panasonic laser printers available at 
highly reduced prices. 

Please phone for up to date 
Information on prices and 
availabllltyt 

St. Albans (0727) 40505 


ABC Compiler (Dabs Press) 

Offer price £66.00 Cbic VAT) + £1.50 p»p 

(Save over ii7.00 on normal BEEBUG price) 

This Basic compiler enables a program written in 
Basic to be compiled into assembly language for 
faster execution and more effidenl use of money. 
Supplied complete with Runtime library. 


Stock Code 0938b 


items Stitt oh’ 


Software Developer's Toolbox 

Offer price £29*95 (Inc VAt) + i3-S0 pSp 
Stock Code 09t8d 


1406a \folum© 3 Special Disc 
PDAl Desktop Applications 
PAOM ArcOmnlbus Games 

PAS3q ArcScon III (complete) 
PAU3a ArcScon III (upgrade) 

(on rotum of ArcScon II dtec) 

1410a RISC User Movie Maker 
1401a RISC User Toolbox (Arch.) 

2420b RISC User Binders 
01Q2b DFS reader 


0106c Hard Disc Companion 
0101 d Hearsay 

0103a Hearsay RISC OS upgrade 
0107c ISO C Dev. System 
0100c Mosterfile Archimedes 
0111b Outline Font Pack 1 
OlOBd Ovation (Beebug DTP) 

0796c Serial Link 

0105a Serial Link RISC OS upgrode 


Ancestry (Minerva) 


Offer price £52.00 (inc VAT) + £1*50 p4fcp 

(Save over £l4.CX) on normal BEEBUG price) 


This popular application from Minerva allows you 
to build up family history data, incltiding scanned 
images where appropriate, For display and 
printout. 


Stock Code 0957b 


l(. X 3.5" Beebug discs 
id library case 

Offer price £7.95 (Inc VAT) + £0.60 p&p 

(Save £3.50 on normal BEEBUG price) 

High quality 3.5" discs from a well known 
manufacturer stipplied complete m a sman and 
convenient case. 


Stock Code 0675a 


Twill 

Offer price £18*95 (inc VAt) + £1*50 p&p 
Stock Code 1083b 


























